Skip to main content
A merge field is a placeholder that is replaced with a contact’s information when the message is sent. For example, if you use Hi {{contact.first_name}}, each person will receive their own name, such as Hi Priya or Hi Sam.

How to add one

In any text box that supports merge fields, type @. A list opens — pick a field and its {{token}} is added to your text box for you. No need to type it yourself.

Where you can use them

Available fields

Contact ID, First Name, Last Name, Full Name, Email, Phone Number, Customer Phone, Display Name, Contact Status, Contact Source, and Assigned To.
Every active customer field you create shows up.
Team Name, Team Email, Team Domain, and Team Subdomain.
Available when you have connected your Shopify store. They use the contact’s most recent order or cart: Order Number, Order Date, Order Total, Subtotal, Shipping Price, Total Tax, Currency, Discount Code, Discount Amount, Items Summary, Payment Status, Payment Method, Fulfillment Status, Shipment Status, Tracking Number, Tracking URL, Cart Recovery Link, Shipping City, Shipping Address, Order Note, Refund Note, Order Status Page Path, and Cart Page Path.

Automation fields

Automation flows add their own fields to the picker. A flow can use answers the customer gave earlier in the chat.
If a contact doesn’t have a value for a merge field, that part stays blank. The message is still sent. You cannot set a default value.

What’s next

Campaigns

Use merge fields to personalize a broadcast.

Customer Fields

Add your own fields so they become merge fields too.
Last modified on November 17, 2026