Customer StoriesYespo Blog
Guides
Request DemoLogin
Start typing to search…

Merge Tags Cheat Sheet

This cheat sheet provides an overview of how to use merge tags effectively in your communications.

Merge tags are a powerful tool for personalizing your communications in Yespo. They allow you to use dynamic content for personalized interactions with the contacts, making each touchpoint more relevant and engaging.

Merge Tags in Messages

In messages, you can use 2 types of merge tags:

  • Standard: Default merge tags.
  • Custom: Additional fields you can create in the system.

These tags substitute the contact information from the contact card you add manually or using API.

Read this article to learn how to personalize your messages using merge tags.

Standard Merge Tags

Name

Merge tag

How it works

First name

${firstName}

Inserts the contact's first name.

Last name

${lastName}

Inserts the contact's last name.

Full name

${firstName}, ${lastName}

Inserts the contact's full name.

Email

${email}

Inserts the contact's email address.

SMS

${sms}

Inserts the contact's phone number.

External customer ID

${externalCustomerId}

Inserts the contact’s unique identifier generated in your system.

Town

${town}

Inserts the city or town name.

Address

${address}

Inserts the contact’s address.

Region

${county}

Inserts the name of the administrative division within a county.

Postcode

${postcode}

Inserts the postal code.

Message name

${messageName}

Inserts the name of the message.

The symbol $ denotes the start and end of merge tags in messages. This indicates that the text between these symbols should be replaced with dynamic content.

You can use a vertical bar (|) after the variable and add alternative text in the format ${firstName|'dear friend'}.

Example:

If the first name exists in the contact card, it will be shown in the message.

If there is no first name, the alternative text will be shown.

📘

Note

  • Field names are case-insensitive. When you insert personalization from the menu, Reteno uses the ${firstName} format by default. However, field names are not case-sensitive, so the following variants work the same way (as long as the field exists in the context):
    • ${firstName}
    • ${firstname}
    • ${FIRSTNAME}
  • Different Velocity notations for the same value. You can reference a field using either $name or ${name}. Curly braces are useful when a variable is placed next to text:
    • Hello, $firstName!
    • Hello, ${firstName}!
    • Hello, ${firstName}Customer! → braces help separate the variable from the text

Updated about 10 hours ago