> For the complete documentation index, see [llms.txt](https://docs.bonomi.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bonomi.io/bonomi-inbox/dynamic-variables.md).

# Dynamic Variables

Personalise your message with dynamic variables

Dynamic variables can be used to personalize outgoing messages. Personalised content contributes to building a good relationship with contacts where they feel their relevance to the context.

## What are the dynamic variables? <a href="#what-are-the-dynamic-variables" id="what-are-the-dynamic-variables"></a>

You can use a dynamic variable simply by adding a prefix, `@contact` or `@field` to the contact field. The following are the example and usage.

### Contact Variables <a href="#contact-variables" id="contact-variables"></a>

| Variable             | Description                                                                                                                                    |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `@contact.name`      | Is replaced by the full name of the contact (First Name + Last Name).                                                                          |
| `@contact.firstname` | Is replaced by the first name of the contact.                                                                                                  |
| `@contact.lastname`  | Is replaced by the last name of the contact.                                                                                                   |
| `@contact.gender`    | Is replaced by the gender of the contact.                                                                                                      |
| `@contact.location`  | Is replaced by the location of the contact. If the contact has no location stored, it will not be replaced and the actual string will be sent. |

### Custom Field Variables <a href="#custom-field-variables" id="custom-field-variables"></a>

| Variable            | Description                                                                                                                                                                                  |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `@contact.email`    | Is replaced by the email address of the contact.                                                                                                                                             |
| `@contact.phone`    | Is replaced by the phone number of the contact.                                                                                                                                              |
| `@field.field_name` | Is replaced by the value in the custom field. For example, if the Custom Field "City" exists and one contact has the value "New York", sending `@field.city` will be replaced by `New York`. |

## How to use a dynamic variable? <a href="#how-to-use-a-dynamic-variable" id="how-to-use-a-dynamic-variable"></a>

### Messaging Console <a href="#messaging-console" id="messaging-console"></a>

You can include a dynamic variable in your message while responding to a contact.![](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-MC6b9IaV8CK1DQKmy6I%2F-MC6bBx-1ACyrTNl5_K0%2Fezgif-4-af97b66f31e2.gif?alt=media\&token=b850328c-7eae-40b1-9d3c-bae1f0e4c78b)

Besides contact fields, you can also include a custom field by typing the custom field's name.![](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-MHFjejGSAb3bAgaGwsx%2F-MHFmkVAAITuMgvwl0H-%2Fdynamic%20custom.gif?alt=media\&token=e936cfc7-2adf-4005-ada0-08a67f923245)

### Snippets <a href="#snippets" id="snippets"></a>

You can use dynamic variables in snippets as well.

![Using dynamic variable in snippet](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-MC6XsgEDCFkQAzoHKpD%2F-MC6aBSEzYhhfUtbrNKJ%2FScreenshot%202020-07-13%20at%205.53.53%20PM.png?alt=media\&token=dd47a10d-2395-467c-8a9c-547dc1a61813)

While composing a snippet content, you can include a dynamic variable to personalise your quick replies.

{% hint style="info" %}
You can have multiple dynamic variables in a single content. Make use of them while composing your messages
{% endhint %}

{% hint style="warning" %}
**Important**: If the field you are trying to send is empty or the field does not exist at all, the string will not be replaced.
{% endhint %}