Every email you send from Loops can contain dynamic content connected to the contact you’re sending to or the event that triggered the email.

Dynamic content is added to emails in the editor using merge tags.

Types of dynamic content

The three email types in Loops have different dynamic content available to them:

  • Campaign emails can contain contact properties.
  • Emails within Loops can contain contact properties and event properties.
  • Transactional emails can contain data variables.

The three types of dynamic content are:

  • Contact properties are pieces of data related to each contact in your audience. There are a set of default properties like name and source, but you can also add any number of custom contact properties. If you sync contact data to Loops with the API, an integration or with CSV uploads, you can include that data in your email.
  • Event properties are pieces of data that can be sent along with every event (which are used to trigger loop emails) via integrations or API calls.
  • Data variables are pieces of data included in transactional emails, which are populated in the API call.

Add dynamic content to emails

To add a dynamic content to emails, simply select the corresponding icon in the toolbar of the email editor, which will add a “merge tag” to your email.

Adding a contact property

Depending on whether you’re editing a campaign, loop or transactional email, you will have different options (explained above).

When the email is sent, the merge tag will be replaced with actual values from the contact, event or data variable.

If you send an email and the merge tag is missing a value, the email will not be sent. Make sure to add fallback values to avoid missed sends.

A common example of using dynamic content is to personalize an email greeting by using a contact’s first name.

Once you’ve clicked on the icon in the toolbar, select the contact property you want to add. In this case, First Name.

Selecting the First Name property

When the email is sent, the contact’s data will be added to your email, like this: Hey Chris, (if the contact doesn’t have a First name value, it will read Hey there,).

Custom properties

Any contact attributes you sync with Loops either through the API or through one of our integrations can be added to an email to personalize it.

Likewise, any data variables you add to your transactional emails, or event properties you add to your events, will also appear as merge tag options in the editor.

For example, say you wanted to create a Scheduled digest email with metrics about a contact over the last week. You could sync those metrics to Loops as event properties.

These properties will then automatically be available as merge tags and in your dropdown within the merge tag menu for any emails triggered by that event.

Inserting an event property

Fallback values

It is important to set a fallback variable for any merge tags you add to your campaign and loop emails.

If a contact does not have a value for the related contact property, or you don’t remember to include an event property for an event-triggered email, the email will fail to send.

Fallback values can be used to make sure default content is added to the email and ensure that it is sent.

For example, if you set a fallback variable for “First Name” as “there”, if a contact does not have this contact property, the email will include “there” in the place of the contact’s name.

This is a great way to make sure that your emails still feel personalized to contacts even if there is no property available.

Merge tag syntax

As well as being adding merge tags using the toolbar icons, dynamic content can be added to emails using merge tags directly in the email body.

For example, if you have a custom contact property named teamName, you can write it surrounded by curly brackets {teamName} in the email to add personalization for contacts.

When the email is sent, the teamName value for each contact will be added to the email.

For a list of all of your contact properties, visit the API Settings page. The API Name is the name you use within the brackets in your email, for example {firstName}, {lastName}, {email}, etc.

Contact properties table

For transactional emails and event properties, you can check the configuration of each to check the available tag names.

It’s important to use camelCase format to type your merge tags, if you have any questions about how to format your merge tags, reach out to us!