Macros
Reusable reply templates that fill in details such as the requester's name. Insert them from the agent reply composer to keep answers consistent.
- Where
- Admin → Settings → Macros · My macros (user menu) · Reply composer
- Permission
- EDIT_REQUESTS (private macros) · Admin role (shared macros)
- Updated
- October 2026
Overview
Macros are reusable reply templates. Apply one to a request from the macro palette in the agent reply composer.
Variables in a macro fill in details from the request, the agent and the workspace. The full list is in the table below.
A macro is shared or private. Shared macros belong to the workspace, and admins manage them under Admin → Settings → Macros.
Private macros belong to the agent who wrote them, under My macros in the user menu. Only an admin can make a macro shared.
The palette lists the shared macros and your own private ones. Search it by name or by the optional shortcut label.
Macros insert text only; they do not change status or other fields. Use an automation when you also want to change status, tag or assign.
Step by step
- 01
Write the macro
Create a shared macro for the workspace, or a private one for yourself. Write the body in Markdown and type variables where the details go.
- Shared: Admin → Settings → Macros → New macro
- Private: My macros (user menu) → New macro
- Enter a name and the body, with variables such as
{{requester.first_name}}typed into it - The admin page also inserts variables from chips and takes an optional category
- To keep a reply you wrote, choose Save this reply as a macro in the composer's macro picker; it saves as private
Example bodymarkdown Hi {{requester.first_name}}, We've received {{request.id}} and are looking into it now. We'll update you as soon as we have more information. Thanks, {{agent.first_name}} - 02
Add a shortcut label
Give the macro a shortcut that starts with a slash, such as
/ack-received. Agents can see and search it in the macro palette. - 03
Insert from the composer
In the reply composer, open the macro palette, search, and insert.
- Variables are filled from the current request and the agent inserting the macro
Variables
Type a variable into a macro body exactly as shown. These are the only variables supported.
| Variable | Fills in |
|---|---|
| {{requester.name}} | Requester's display name |
| {{requester.email}} | Requester's email address |
| {{requester.first_name}} | Requester's first name |
| {{request.id}} | Request number (for example EVT-1234) |
| {{request.title}} | Request subject |
| {{request.type}} | Request type name |
| {{request.status}} | Current request status |
| {{agent.name}} | Name of the agent inserting the macro |
| {{agent.first_name}} | First name of the agent inserting the macro |
| {{org.name}} | Your organization's name |