Home > How to: use Shortcuts

Categories: |

(Last Updated On: November 30, 2018)

Here are the shortcut rules:

1. Only the admin can add or delete a shortcut from within the Admin Dashboard.
2. Each message can be up to 450 characters. (If you want more information you can split the message between two canned responses.)
3. There is no limit to the number of shortcuts that can be added, but keep in mind that your agents will need to navigate through the options.

Here is how to add a shortcut:

1. Log into your Admin Dashboard and go to your Settings.

2. Select Agent Settings, and go to Shortcuts.

3.  At the bottom, click “Add new shortcut”.

4. Enter a command (4.1) followed by the message (4.2). The command is what an agent will type during a chat and the message is what will appear when the command is selected. You don’t need to add the \ before the command, as this is automatically added to each Shortcut. You will then need to click the checkbox next to the command you just added (4.3).

5. Don’t forget to Save Changes (5).

It is worth noting that you can also search through your list of Shortcuts, to see if the one you are about to add already exists. Searching will search both the command and the message of the shortcut.

How to use your shortcuts:

Either if you are using SnapEngage Chat Portal or the new SnapEngage Hub and you have a command called “how” for example, you could use the shortcut by typing in \how in the text field (6) and hitting enter. Keep in mind that Shortcuts will only work while in an active chat with a visitor, and will not work in a Team Chat with a colleague.

You will also see some recommended Shortcuts while typing a message to a visitor. For example, if I type “how” in the text field the following options would be shown:

Legacy Chat Portal view


Hub view


By default, both the shortcut command and message are shown in the auto-completion list. If you want to only see the command you can change it in the Agent Preferences dialog from the chat portal (7):

Viewing Available Shortcuts

Legacy Chat Portal view

In the Chat Portal, you can view a list of your available Shortcuts by clicking on the dots-and-dashes icon in the text field of the chat. You can search through your list of Shortcuts by typing in the search field (8) at the top of the list.


Hub view

In the Hub, you can view a list of your available Shortcuts by clicking on the Shortcuts button while in an active chat. This will prompt a window to pop up showing all Shortcuts, also in the search field you can search for a specific shortcut (9).



You can view all of your canned messages in a CSV document by clicking on the “Export” icon (10) in the Shortcuts tab. This can be helpful when a new agent is learning the shortcuts, as they can use this to reference the available Shortcuts. You can also upload new ones (11) here as well!

Importing shortcuts need to be imported as a CSV and using the following format. Column A is the Command and Column B is the message. Do not add slashes to the commands as we auto add them after import. If you are unsure about the format, create some test shortcuts in the Shortcuts tab, and export the .CSV file. You can then add your shortcuts in to the file!

When importing the Shortcuts, you will see two options, Append, and Replace:

Append will add the new Shortcuts to the existing list. This is most useful when you are adding completely new shortcuts to the existing list. Keep in mind that if a shortcut with the same command name already exists, you may have multiple commands with the same name, which may cause confusion. We would suggest using Replace if a lot of Shortcuts are existing.

Replace will remove all existing shortcuts and replace them with the new Shortcuts. All previously added Shortcuts would be lost. This is useful if you have just edited your existing shortcuts, and you no longer want the previous versions to be available.

Note: Parameters and JavaScript variables can also be used inside shortcuts (12).


  • Hello, my name is {alias}. To use more than one variable, you will need to add a <br> tag.
  • Thank you for checking out our {js:product_name}
  • Your case record number is {js:caseId}

Did you find this article helpful?

Not HelpfulNeeds WorkSo-soHelpfulVery Helpful (27 votes, average: 3.81 out of 5)
Loading ... Loading ...

Published October 31, 2012

Reader Feedback

No comments yet

Add your thoughts