--- title: Merge Fields description: Merge Fields allow you to personalize messages to different contacts based on the information you have saved to their contact details. Merge Fields can be accessed in Compose Message, Templates, or replies in Conversations. --- [Skip to content](https://help.textrequest.com/merge-fields#main-content) [![favicon-256.png\]](https://help.textrequest.com/hs-fs/hubfs/favicon-256.png?width=30&height=30&name=favicon-256.png)](https://help.textrequest.com/?hsLang=en) Open main navigation Close main navigation - [Back to textrequest.com](https://www.textrequest.com/) [Back to textrequest.com](https://www.textrequest.com/) Hi! How can we help you today? - There are no suggestions because the search field is empty. 1. [Text Request Help Center](https://help.textrequest.com/?hsLang=en) 2. [Messages](https://help.textrequest.com/messages?hsLang=en) 3. [Messaging Features](https://help.textrequest.com/messages?hsLang=en#messaging-features) # Merge Fields ## Merge Fields allow you to personalize messages to different contacts based on the information you have saved to their contact details. Merge Fields can be accessed in Compose Message, Templates, or replies in Conversations. There are two types of Merge Fields you can add to messages: - **Contact Merge Fields** — These merge fields use information from a contact's custom fields, found in their contact details card.  - **User Merge Fields** — These merge fields use information from a user's profile, including first name, last name, and email address. General information, such as the contact's first name, will automatically appear, but if you want to include their email or birthday, you'll need to create a Custom Field for that. Learn more by visiting our [Custom Fields help document](https://help.textrequest.com/custom-fields?hsLang=en). **Note:** Merge Fields are not available in P2P. For information on Merge Fields in Group Messages, [see our guide](https://help.textrequest.com/group-message-merge-fields?hsLang=en).  #### **To add a Merge Field to a new message:** **1.** Click **Compose Message**. ![Compose Message](https://help.textrequest.com/hs-fs/hubfs/Help%20Center/Compose%20Message.gif?width=626&height=173&name=Compose%20Message.gif) **2.** Add a **Contact** you want to message. **3.** Click the **\[ \]** icon. **4. **Select **Contact details** or **My details** depending on the type of merge field you want to add. **5.** Click the **Merge Field(s)** you want to add to your message. **6.** Click **Send** when your message is ready. ![Merge Fields Compose Final - Copy](https://help.textrequest.com/hs-fs/hubfs/Help%20Center/Merge%20Fields%20Compose%20Final%20-%20Copy.gif?width=688&name=Merge%20Fields%20Compose%20Final%20-%20Copy.gif) **Note:** You can also add **Merge Fields** to **Thread Replies** and **Quick Replies**. Just find the conversation you want to respond in and follow **Steps 3-5** of the guide above. ### Defining Fields & Chips ###                                        ![Teal Chip](https://help.textrequest.com/hs-fs/hubfs/Help%20Center/Teal%20Chip.png?width=123&name=Teal%20Chip.png)           ![Gray Chip](https://help.textrequest.com/hs-fs/hubfs/Help%20Center/Gray%20Chip.png?width=123&name=Gray%20Chip.png) **     Defined ChipUndefined Chip** When you add Merge Fields to a message, you must have all of those fields defined before the message can be sent. If you do have an undefined merge field in your message, there are three ways to define it: 1. Click each **Undefined (gray) Chip** individually. You can then update and save that contact’s information directly. 2. Click the **SEND** button anyway. This launches a modal that allows you to complete the missing fields and update the contact’s information. 3. Click **Update Fields** (red exclamation mark). This launches the same modal as sending the message, allowing you to complete the missing fields and update the contact’s information.  Learn more about editing a contact’s information in our [Contact Details](https://help.textrequest.com/contact-details?hsLang=en) article.  ### Merge Fields & Templates #### **To add Merge Fields to Templates:**  **1.** Navigate to **Templates**. **2.** Click **+ New Template**.  **3.** Write your **Template** message. **4.** Click **\[ \]** anytime you want to add a **Merge Field** to your message.  **5.** Click **Add Template** when you’re done. ![Merge Field Template Final - Copy](https://help.textrequest.com/hs-fs/hubfs/Help%20Center/Merge%20Field%20Template%20Final%20-%20Copy.gif?width=688&name=Merge%20Field%20Template%20Final%20-%20Copy.gif) As you can see above, chips will initially be gray when making the template. Once the template is added to a composed message or reply, defined fields will turn teal. Just like when using Merge Fields for messages, you will need to update undefined chips before the message can be sent.   Learn more about what Templates can provide by visiting our [Templates](https://help.textrequest.com/templates?hsLang=en) article.  ### How This is Useful By adding **Merge Fields** to **Templates**, you can create templates that are personalized to multiple contacts. In the above example, that same message could be sent to multiple contacts, but contain each contact’s personal information.  **John Smith’s message:**  “Hi, John Smith. We reached out to your email at jsmith@gmail.com.”  **Jane Doe’s message:**  “Hi, Jane Doe. We reached out to your email at jdoe@gmail.com.”  Merge Fields help add that personal touch for your contacts while making your life easier. Try them out!   - [Basics](https://help.textrequest.com/basics?hsLang=en#main-content) - [Account Essentials](https://help.textrequest.com/basics?hsLang=en#account-essentials) - [Profile Settings & Preferences](https://help.textrequest.com/basics?hsLang=en#profile-settings-preferences) - [Messages](https://help.textrequest.com/messages?hsLang=en#main-content) - [Conversations](https://help.textrequest.com/messages?hsLang=en#conversations) - [Messaging Features](https://help.textrequest.com/messages?hsLang=en#messaging-features) - [Group Messages](https://help.textrequest.com/messages?hsLang=en#group-messages) - [Sequences](https://help.textrequest.com/messages?hsLang=en#sequences) - [Peer to Peer](https://help.textrequest.com/messages?hsLang=en#peer-to-peer) - [Contacts](https://help.textrequest.com/contacts?hsLang=en#main-content) - [Individual Contacts](https://help.textrequest.com/contacts?hsLang=en#individual-contacts) - [Groups](https://help.textrequest.com/contacts?hsLang=en#groups) - [Managing Contacts](https://help.textrequest.com/contacts?hsLang=en#managing-contacts) - [Payments](https://help.textrequest.com/payments?hsLang=en) - [Settings](https://help.textrequest.com/settings?hsLang=en) - [Reports](https://help.textrequest.com/reports?hsLang=en) - [Integrations](https://help.textrequest.com/integrations?hsLang=en#main-content) - [Text Request Extras](https://help.textrequest.com/integrations?hsLang=en#text-request-extras) - [Third-Party Integrations](https://help.textrequest.com/integrations?hsLang=en#third-party-integrations) - [Mobile App](https://help.textrequest.com/integrations?hsLang=en#mobile-app) - [Users](https://help.textrequest.com/users?hsLang=en) - [Dashboards](https://help.textrequest.com/dashboards?hsLang=en) - [Account](https://help.textrequest.com/account?hsLang=en#main-content) - [10DLC Registration](https://help.textrequest.com/account?hsLang=en#10dlc-registration) - [Reviews](https://help.textrequest.com/reviews?hsLang=en) [![TR Esendex Footer](https://help.textrequest.com/hs-fs/hubfs/Help%20Center/TR%20Esendex%20Footer.png?width=225&height=45&name=TR%20Esendex%20Footer.png "TR Esendex Footer")](https://www.textrequest.com) Copyright © 2026, Text Request