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

# Enabling and using merge fields in messaging

# What are merge fields?

Merge fields are dynamic placeholders that can be inserted into messages to display specific information about the recipient. For example, you can use a merge field to display the recipient's first name, last name or even the value of a specific custom field.

## Enabling merge fields

There are basic merge fields, custom field merge fields and external system merge fields. Basic merge fields, like "First name", "Last name", and "Employer" are always available, but custom field merge fields will need to be enabled by a project admin in the custom field's Edit page.

<img src="https://mintcdn.com/broadstripes/TvynBoPFj_YPJvY-/images/communications/edit-custom-field-mergefield.png?fit=max&auto=format&n=TvynBoPFj_YPJvY-&q=85&s=55a68861021d5376be9bc853739ab2ae" alt="Merge Field - Custom Field" width="849" height="471" data-path="images/communications/edit-custom-field-mergefield.png" />

External system merge fields will need to be enabled by a project admin in the external system's Edit page.

<img src="https://mintcdn.com/broadstripes/TvynBoPFj_YPJvY-/images/communications/edit-external-system-mergefield.png?fit=max&auto=format&n=TvynBoPFj_YPJvY-&q=85&s=1ed8b1ad2e8ab3dab877b0f8661906d3" alt="Merge Field - External System" width="917" height="515" data-path="images/communications/edit-external-system-mergefield.png" />

## Using merge fields

When creating a message, you can use merge fields by adding the merge field name in the message body. For example, to use the "First name" merge field, you would select "First name" from the merge field dropdown in the **Send SMS** or **Send Email** panel.

<img src="https://mintcdn.com/broadstripes/D7SDSdJSKl1YrpjO/images/communications/sms-mergefieldlist.png?fit=max&auto=format&n=D7SDSdJSKl1YrpjO&q=85&s=59e8c3a76f97655000a9a213af51369b" alt="Merge Field - Send SMS" width="746" height="480" data-path="images/communications/sms-mergefieldlist.png" />

You may also add merge fields to an email template by inserting the merge field name in the email template body. For example, to use the "First name" merge field, you would insert the merge field by selecting the "First name" in the **Merge tags** dropdown menu.

<img src="https://mintcdn.com/broadstripes/TvynBoPFj_YPJvY-/images/communications/email-template-mergefieldlist.png?fit=max&auto=format&n=TvynBoPFj_YPJvY-&q=85&s=1eed530b41b815fa29f8fe59f1abd36f" alt="Merge Field - Email Template" width="1682" height="556" data-path="images/communications/email-template-mergefieldlist.png" />
