Skip to content

Documentation

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

  1. 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}}
  2. 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.

  3. 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.

VariableFills 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