> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatflows.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Personalize messages with merge fields

> Add the customer's name, order number, tracking link or cart link to a message, so every customer gets a message written for them.

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

* The [Inbox](https://docs.chatflows.io/messaging/live-chat.md) reply box
* [Quick replies](https://docs.chatflows.io/core-setup/canned-replies.md)
* [Campaigns](https://docs.chatflows.io/messaging/campaigns.md)
* [WhatsApp template](https://docs.chatflows.io/messaging/whatsapp-templates.md) variable values
* [Sending a template to one contact](https://docs.chatflows.io/contacts/managing-contacts.md#actions-on-a-single-contact) from a contact row
* [Automation flows](https://docs.chatflows.io/automation/flow-builder.md)

## Available fields

> [accordion] Contact fields
>
> Contact ID, First Name, Last Name, Full Name, Email, Phone Number, Customer Phone, Display Name, Contact Status, Contact Source, and Assigned To.

> [accordion] Custom fields
>
> Every active [customer field](https://docs.chatflows.io/core-setup/custom-fields.md) you create shows up.

> [accordion] Team fields
>
> Team Name, Team Email, Team Domain, and Team Subdomain.

> [accordion] Shopify order fields
>
> Available when you have [connected your Shopify store](https://docs.chatflows.io/shopify/shopify-admin-app.md). 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](https://docs.chatflows.io/automation/flow-builder.md) add their own fields to the picker. A flow can use answers the customer gave earlier in the chat.

> [!WARNING]
>
> 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

> [card] [Campaigns](https://docs.chatflows.io/messaging/campaigns.md)
>
> Use merge fields to personalize a broadcast.

> [card] [Customer Fields](https://docs.chatflows.io/core-setup/custom-fields.md)
>
> Add your own fields so they become merge fields too.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.