Creating macros for tickets

Unlike triggers and automations, macros only contain actions, not conditions. Conditions aren't used because nothing is automatically evaluating tickets to determine if a macro should be applied. Agents evaluate tickets and apply macros manually as needed.

Macros can perform tasks:

• Add comment text
• Update ticket fields
• Add or remove ticket tags
• Add CCs
• Change the assignee
• Set the ticket subject
• Add attachments to ticket comments

There are two types of macros: personal macros (created by an agent or administrator for their own use) and shared macros (created by an administrator or an agent in a custom role with permission for multiple users).

This article contains the following topics:

• Creating personal macros for tickets (agents)
• Creating personal or shared macros for tickets (administrators)
• Adding formatting and inline images to macro comments
• Adding attachments to macro comments
• Adding an alternate plain text version of a rich content macro comment

Related articles:

• Using macros to update tickets
• Organizing and managing your macros

Tip: Fine Tuning: Learn how to improve your agents' productivity in Sylviana Ho's Fine Tuning: Agent Productivity.

Creating personal macros for tickets (agents)

Although only administrators can create the macros that are shared by all Zendesk Support agents, agents can create personal macros for their own use. A personal macro is only visible to and can only be used or modified by the creator. 

You can create macros from scratch, as described here, or you can create macros based on existing tickets.

Note: Personal macros are available on Team, Professional, and Enterprise.

To create a personal macro for tickets

1. Click the Admin icon () in the sidebar, then select Macros.
2. Click the All shared macros drop-down menu and select Personal macros.
3. Click the Add macro button.
4. Enter the macro name, and add actions for your macro as described in Building macro action statements.
5. Click Create.

Your personal macros are added to the list of available macros.

Creating personal or shared macros for tickets (administrators)

Administrators (and agents in custom roles with permission) can create macros that are shared by all Zendesk Support agents or macros that are shared by only agents in a specific group. Administrators can also create personal macros for their own use.

A personal macro is only visible to and can only be used or modified by the creator. Administrators can create shared macros, and can modify all shared macros, regardless of who created them.

You can create macros from scratch, as described here, or you can create macros based on existing tickets.

To create a personal or shared macro for tickets

1. Click the Admin icon () in the sidebar, then select Macros.
2. Click the Add macro button.
3. Enter a Macro name.
4. (Optional) Enter a Description.
5. Select an option from the Available for menu:
   • All agents, available to all agents.
   • Agents in group, available only to agents in the group specified. A drop-down menu to choose the group appears when you select this option.
   • Me only, available only to you.

   

   Note: The Agents in group option is available on Professional and Enterprise. Personal macros are available on Team, Professional, and Enterprise.
6. Under Actions, use the drop-down menus to add actions for your macro as described in Building macro action statements.

   If you choose the Comment/description macro action, and you have rich text formatting enabled, you can add formatting and inline images and you can add attachments to your macro comments.

7. Click Create.

Adding formatting and inline images to macro comments

If you have rich text formatting enabled, you can add styling, formatting, and inline images to the Comment/description macro action. An administrator must enable this setting. For details, see Enabling formatting options for agents.

To add formatting to your comment

1. In the macro, under the comment box, click the T at the bottom of the field.

   

   This opens the rich text editor interface:

   

2. Select the formatting you want to apply to the text.

   Toolbar button	Formatting	Keyboard shortcuts
   	Increase/decrease heading style	Increase: Ctrl + + ⌘ + + (Mac) Decrease: Ctrl + - ⌘ + - (Mac)
   	Bold	Ctrl + B ⌘ + B (Mac)
   	Italicize	Ctrl + I ⌘ + I (Mac)
   	Bulleted list	Ctrl Shift + 8 ⌘ + Shift + 8(Mac)
   	Numbered list	Ctrl + Shift + 7 ⌘ + Shift + 7 (Mac)
   	Decrease paragraph indentation	Ctrl + [ ⌘ + [ (Mac)
   	Increase paragraph indentation	Ctrl + ] ⌘ + ] (Mac)
   	Block quote	Ctrl + Shift + 9 ⌘ + Shift + 9 (Mac)
   	Code block	Ctrl + Shift + 6 ⌘ + Shift + 6 (Mac)
   	Code span	Ctrl + Shift + 5 ⌘ + Shift + 5 (Mac)
   	Hyperlink	Ctrl + K ⌘ + K (Mac)
   	Horizontal line	Ctrl + Shift + L ⌘ + Shift + L (Mac)

If you created a macro with the Comment/description action before the addition of rich text formatting, you can update your macro by clicking the Use rich content link. This copies your existing comment action, loads in the rich content editor, and places your comment back into the editor. You can then apply formatting and images or attachments as needed.

Now you can add a plain text version of you rich content macro comment, if you want. The plain text version will be intelligently applied in channels that don't support rich text formatting.

To add inline images to your comment

• Drag and drop an image from your computer into the comment window, or paste a copied image into the window by right-clicking and selecting Paste or by pressing Ctrl or ⌘ + V.

Adding attachments to macro comments

Comments in your macros can also contain up to five file attachments.

The maximum file size for the Zendesk Support plans are as follows:

• 1 MB for Essential
• 7 MB for Team
• 20 MB for Professional and Enterprise

To attach one or more files to a comment

1. Click the paperclip icon in the at the bottom of the field.

   

2. Browse to the file you want to attach.
3. Select the file, and click Choose.

   The file is added to the ticket.

Adding an alternate plain text version of a rich content macro comment

If you added styling, formatting, or inline images to the Comment/description macro action, you can add an alternate plain text version, if you want.

The plain text version will be intelligently applied in channels that don't support rich text formatting. These include the Zendesk mobile app, Zendesk SMS, the Zendesk Facebook or Twitter integrations, and any of the Zendesk channel apps.

To add a plain text version of your rich content macro comment

1. In the macro, under the rich content version of the comment, select Include plain text fallback.

   

2. In the pre-populated version that appears, make any modifications needed to create the plain text version of the macro comment.