How to create and use macros for Inbox tickets

Estimated 6 minute read
|
Updated May 20, 2025, 9:59 PM EST
You will learn

You will learn

Find out how to create and use macros (previously called “quick responses”) in the Klaviyo Inbox. Macros are pre-written, reusable responses your support agents can insert into replies for SMS and web chat tickets.

Before you begin

Before you begin

There are a few important things to remember before using macros:

  1. Before you can add a macros, you need at least 1 active message in your Inbox, either: 
    • 1 web chat.
    • 1 SMS from a subscriber. 
    • 1 Email message
  2. Macros used in SMS tickets are billed the same as any other SMS message in your billing plan.

New to using tickets in the Klaviy Inbox? Check out our guide to the Klaviyo Inbox for more information.

About macros

About macros

Macros are designed to save your support team time by eliminating the need to repeatedly type responses to common inquiries. They’re helpful when customers frequently ask similar questions, and for standardizing consistent messaging and tone. 

You can create different macros for different types of support requests (e.g., shipping time, returns policy, or order status), and organize them by category. This makes it easy for your support team to quickly find and insert the right response for each customer ticket. 

Macro1.jpg

Personalization supported in macros

Personalization supported in macros

Additionally, the macros you create can include profile and order personalization variables, which act as placeholders that automatically insert customer data each time the macro is used. Personalization variables streamline the support workflow, so agents don’t need to search for or manually enter customer information in every reply. 

Note that Klaviyo can only auto-populate customer data for the profile and order variables shown in the dropdown menus in the macro creation modal. These available options are listed and defined at the bottom of this guide in the Personalization available for macros section.

Example macros

Example macros

Title: Where’s my order?

Message: Hi {{first_name}}! Thanks for reaching out. Let me check on the status of your {{order_name}}.

Title: Order arrival

Message: Hi {{first_name}}! So happy you purchased {{order_id}}. Your order is arriving to {{shipping_address}} and is estimated to arrive on estimated_delivery_at. 

 

Create a new macro

Create a new macro

To add a macro:

  1. Navigate to Conversations > Inbox.
  2. Click the gear icon to open your Inbox settings.
  3. Select Macros.
    Macro2.jpg
  4. Click Create macro
  5. Click Add macro to open the creation modal.
    Macro3.jpg
  6. Under Title, enter a name that reflects the macro’s purpose (e.g., Refund request)
  7. In the Message body text box, input your message content. To further customize your response, you can:
    • Click the smile icon to add emojis.
    • Select the person icon to insert profile personalization (e.g., first name).
    • Click the package icon to insert order personalization (e.g., Order ID).
  8. Open the Category dropdown menu to select an existing tag or create a new one. Tags are used to group similar macros by topic, like putting all shipping-related responses together, to help your support team quickly find the right macro.
  9. Under Status, choose either Active or Draft.
    • Active means they can be inserted into messages from the quick insert menu in a ticket. 
    • Inactive means they cannot be inserted into a ticket and are hidden from the quick insert menu. Inactive macros can only be accessed from the Macros settings page.
      Macro4.jpg
  10. Click Add to save the macro.

All macros you create are stored on the Macros settings page. Note that macros with order and profile personalization appear as personalization tags on this page. However, when used in a ticket reply, these tags will be replaced with the relevant customer data.

Insert a macro into a ticket

Insert a macro into a ticket

To use a macro in a ticket: 

  1. In your Inbox, click into a ticket.
  2. Click the lightning bolt icon below the reply field to open the macro quick insert menu.
    Macro5.jpg
  3. Select the macro you want to use.
    Macro6.jpg
  4. A preview modal appears when you select a macro, displaying any personalized content. If customer data for a personalization tag is unavailable, it will show as "No_[personalization tag]".
  5. Insert the macro into the reply box by pressing Enter or the forward arrow key. Be aware that macros lacking customer data for personalization will insert a blank space.
    Macro7.jpg
  6. Edit the response as needed in the reply field.
  7. Click the send button.
Personalization (dynamic content) available for macros

Personalization (dynamic content) available for macros

Supported profile personalization

Supported profile personalization

Profile personalization auto-populates properties from a user’s Klaviyo profile. The following profile personalization is supported in macros:

Profile personalization

Description

first_name

The person’s first name.

last_name

The person’s last name.

email

The person’s email address.

phone_number

The person’s phone number.

address

The person’s home address.

Supported order personalization

Supported order personalization

Order personalization in macros automatically fills in customer order details from Shopify. The following order data is supported in macros:

Order personalization

Description

order_id

The unique numeric identifier for the order.

order_name

The human-readable name or number assigned to the order (e.g., "#1001").

customer_email

The email address of the customer who placed the order.

customer_first_name

The first name of the customer associated with the order.

customer_display_name

The display or full name of the customer (may include first and last name).

shipping_address

The address where products in the order will be shipped.

payment_info_billing_name

The name associated with the billing information used for payment.

price_breakdown_currency

The currency code (e.g., USD, EUR) used for the order.

price_breakdown_shipping

The total shipping cost for the order.

price_breakdown_total

The total price of the order, including all charges.

price_breakdown_tax

The total tax amount applied to the order.

price_breakdown_discount

The total discount applied to the order.

price_breakdown_subtotal

The subtotal price of the order before discounts, shipping, and taxes.

price_breakdown_totals_before_tax

The total amount of the order before taxes are applied.

updated_at

The date and time the order was last updated.

status

The current fulfillment or payment status of the order.

estimated_delivery_at

The estimated date and time for delivery of the order.

latest_fulfillment_display_status

The status of the most recent fulfillment event for the order.

 

latest_fulfillment_tracking_url

The tracking URL for the latest fulfillment, if available.

latest_fulfillment_estimated_delivery_at

The estimated delivery date of the latest fulfillment.

is_refunded

Indicates if the order has been fully refunded.

created_at

The date and time when the order was created.

canceled_at

The date and time the order was canceled, if applicable.

Additional resources

Additional resources

Was this article helpful?
Use this form only for article feedback. Learn how to contact support.

Explore more from Klaviyo

Community
Connect with peers, partners, and Klaviyo experts to find inspiration, share insights, and get answers to all of your questions.
Live training
Join a live session with Klaviyo experts to learn about best practices, how to set up key features, and more.
Support

Access support through your account.

Email support (free trial and paid accounts) Available 24/7

Chat/virtual assistance
Availability varies by location and plan type