Personalisation

The content and the subject take variables between double braces, and a small language of conditions and loops. No code is run: the engine understands only what is described here. The Variables button of each editor lists the ones available; one click copies a variable.

Variables

In campaigns and automations

Variable	Value
`{{ subscriber.first_name }}`	First name
`{{ subscriber.last_name }}`	Last name
`{{ subscriber.email }}`	E-mail address
`{{ subscriber.attributes.city }}`	A custom attribute (replace `city`)
`{{ list.name }}`	The list’s name
`{{ unsubscribe_url }}`	The unsubscribe link
`{{ preferences_url }}`	The link to the preferences page
`{{ organisation.address }}`	The organisation’s postal address (Settings → General)
`{{ webview_url }}`	The link to the web version
`{{ campaign.name }}`, `{{ campaign.subject }}`	Campaigns: name and subject
`{{ mail.name }}`, `{{ mail.subject }}`	Automation e-mails: name and subject

In the confirmation and welcome e-mails

The same subscriber and list variables, plus {{ confirm_url }}, the confirmation link.

In transactional e-mails

The variables are the ones your application sends. With:

{ "customer": { "name": "Ada" }, "order": { "number": "A-1024", "paid": true } }

you write {{ customer.name }} and {{ order.number }}. See Transactional e-mails through the API.

A variable that is unknown or empty is replaced with an empty string. Values are escaped in the HTML: a first name holding <script> is shown as it is, and does not run.

Conditions

{% if subscriber.first_name %}
  Hello {{ subscriber.first_name }},
{% else %}
  Hello,
{% endif %}

Form	True when
`{% if name %}`	the value is set (not empty)
`{% if name == "value" %}`	equal, case ignored
`{% if name != "value" %}`	different
`{% if name contains "value" %}`	contains the text
`{% unless name %}`	the opposite of `if`

{% else %} is optional; if is closed with {% endif %}, unless with {% endunless %}.

{% if subscriber.attributes.plan == "pro" %}
  Thank you for being a Pro customer: delivery is on us.
{% endif %}

Loops

<ul>
{% for line in order.lines %}
  <li>{{ line }}</li>
{% endfor %}
</ul>

The loop runs over a list of plain values (["Sourdough bread", "Brioche"]) or over text separated by commas. It stops at 500 items.

A loop over a list of objects ([{"name": "Bread", "price": 3}]) will not show {{ line.name }}: prepare, on your application’s side, a list of lines already written out, such as "Sourdough bread — 3,000 FCFA".

Two variables you cannot leave out

A campaign does not go out without:

{{ unsubscribe_url }}: a visible unsubscribe link;
{{ organisation.address }} (or the address written out in full): the sender’s postal address.

Both are legal requirements for any marketing e-mail. The simplest thing is to put them in your template.

Getting started

Contacts

Content

Campaigns

Automations

Transactional e-mails

Deliverability

Account and team

Personalisation

Variables

In campaigns and automations

In the confirmation and welcome e-mails

In transactional e-mails

Conditions

Loops

Two variables you cannot leave out

​Variables

​In campaigns and automations

​In the confirmation and welcome e-mails

​In transactional e-mails

​Conditions

​Loops

​Two variables you cannot leave out

Variables

In campaigns and automations

In the confirmation and welcome e-mails

In transactional e-mails

Conditions

Loops

Two variables you cannot leave out