- Unsubscribe
<a href="https://$UNSUB$">Unsubscribe</a>- First name
{{ contact.data.firstname }}(Liquid (and @FIELD@ personalisation))- With a fallback
@FIRSTNAME@ with "there" set as the field's default value (Settings > Contacts > Contact data fields)- View in browser
<a href="https://$CANTREAD$">View in browser</a>- Preferences
<a href="https://$PREFCENTRE$">Manage preferences</a>
The Dotdigital unsubscribe link
Put this in the footer of every marketing email you code for Dotdigital:
<a href="https://$UNSUB$">Unsubscribe</a>
- $UNSUB$ is required in raw HTML or the send is rejected; never put it inside a dynamic content block.
The law in most countries also wants the unsubscribe to be easy to find and free to use: see the email rules by country.
Personalisation in Dotdigital: first name with a fallback
Dotdigital uses Liquid (and @FIELD@ personalisation). A first name on its own:
{{ contact.data.firstname }}
With a fallback, so an empty field never shows a blank or a raw tag:
@FIRSTNAME@ with "there" set as the field's default value (Settings > Contacts > Contact data fields)
Showing something only to some people (an if / else):
<!--{% if contact.data.tier == 'gold' %}-->Gold offer<!--{% else %}-->Standard offer<!--{% endif %}-->
View in browser, preferences and address tags
- View in browser:
<a href="https://$CANTREAD$">View in browser</a> - Preferences:
<a href="https://$PREFCENTRE$">Manage preferences</a>
Making a coded template editable in Dotdigital
EasyEditor template markup: ee_element makes a draggable building block, ee_editable an editable td or img inside it, ee_dropzone a td or div blocks can be dropped into.
<td class="ee_dropzone"><table class="ee_element" width="100%"><tr><td class="ee_editable"><p>Editable text</p></td></tr></table></td>
Getting your HTML into Dotdigital
Content > Templates > Custom email templates > Upload template: HTML, CSS and images one by one or as a ZIP. HTML without EasyEditor markup can be sent but not edited.
Limits worth knowing
- Files up to 15 MB each, ZIPs up to 50 MB; images in the same folder as the HTML, not an images folder.
- EasyEditor inlines CSS from internal stylesheets.
- Wrap Liquid logic in HTML comments so <, > and & are not converted on save.
- Liquid is not processed in subject lines or dynamic content rules.
What Dotdigital calls things
Every platform has its own words for the same ideas. Dotdigital's, in plain English:
| The idea | Dotdigital calls it | Worth knowing |
|---|---|---|
| One-off send | Campaign | A single email, SMS or WhatsApp message built and sent once to chosen lists or segments. Campaign means the message itself, not a multi-asset initiative as elsewhere. |
| Automated journey | Program | A multi-step automation on a canvas moving contacts through sends, delays and decisions. Spelled the US way despite the product’s UK spelling elsewhere. |
| Trigger / entry | Program start conditions | The rules deciding which contacts are enrolled onto a program, and when. Older articles call these program start rules. |
| Static group | List | A stored group of contacts filled by import or manually; it doesn’t update itself. Renamed from Address book, integrations and older articles still say address book. |
| Dynamic group | Segment | A rule-based group that rebuilds to include every contact currently matching. Segments rebuild on a refresh, so counts can lag behind live data. |
| Customer record | Contact | One person, identified by email address or mobile number, with their data fields. |
| Custom field | Contact data field | A custom field holding extra information for segmenting and personalisation. Fields are account-wide, not per list, every contact gets the field. |
| Behavioural event | Event (Dotdigital Tag) | A named customer action captured from your site or app, such as a product view. |
| Reusable block | Custom building block | A block designed once in EasyEditor and saved to reuse in later campaigns and pages. |
| Template | Template | A saved campaign design used as the starting point for new campaigns. |
| Personalisation language | Liquid | The markup language for personalisation, conditions and loops. Basic personalisation strings and Liquid are two separate syntaxes. |
| Fallback value | Fallback value | Alternative text shown when a contact has no value in the field you’re personalising with. |
| A/B test | Split test | Sends variants to samples of your audience, optionally auto-sending the winner. Send time optimisation cannot be used on split test campaigns. |
| Suppression | Suppression list | Contacts stopped from receiving anything, unsubscribes, bounces and complaints. Suppression overrides list membership; removing someone from a list doesn’t suppress them. |
| Transactional | Transactional email | Order confirmations sent via SMTP or API, using a triggered campaign as the template. You still build the design as a triggered campaign inside the marketing account. |
| Preference centre | Preference centre | A hosted page where contacts choose which marketing preferences they want. |
| Send-time optimisation | Send time optimisation | Sends each contact their email when they’re most likely to open it. |
| Reporting | Analytics | Campaign, channel, contact and commerce performance. |
| Imported data table | Insight data | Custom tables of extra data such as orders or bookings, linked to contacts or the account. Insight data cannot drive Dynamic content rules, only segments and Liquid. |
| API-triggered send | Triggered campaign | A campaign held ready to fire from an API call, SMTP request or program node. A normal campaign converted to triggered, not a separate asset type. |
| Draft vs live | Draft / Active | Programs only run once activated; deactivating stops enrolment and allows editing. An active program is read-only, deactivate before changing anything. |
What we couldn't confirm
We only list what Dotdigital's documentation says. These points weren't clear from it, so test them in your account:
- No Liquid default filter is documented; the fallback is the data field's default value.
- The editable example combines the three classes as the docs describe them; it is not copied from the docs.
- No postal address tag found.
Questions
What is the unsubscribe tag in Dotdigital?
https://$UNSUB$. $UNSUB$ is required in raw HTML or the send is rejected; never put it inside a dynamic content block.
How do I add a first name with a fallback in Dotdigital?
Dotdigital uses Liquid (and @FIELD@ personalisation). A first name is {{ contact.data.firstname }}, and with a fallback: @FIRSTNAME@ with "there" set as the field's default value (Settings > Contacts > Contact data fields)
How do I add a view-in-browser link in Dotdigital?
Use https://$CANTREAD$.
How do I get a custom HTML email into Dotdigital?
Content > Templates > Custom email templates > Upload template: HTML, CSS and images one by one or as a ZIP. HTML without EasyEditor markup can be sent but not edited.
Sources
- marketing.help.dotdigital.com/en/articles/8198938-link-placeholders-in-easyeditor
- marketing.help.dotdigital.com/en/articles/8198942-script-content-with-advanced-personalisation
- marketing.help.dotdigital.com/en/articles/8198835-set-a-default-value-for-a-contact-data-field
- marketing.help.dotdigital.com/en/articles/8198926-upload-a-custom-html-email-template
- marketing.help.dotdigital.com/en/articles/8198937
- marketing.help.dotdigital.com/en/articles/8198929-easyeditor-template-markup-overview
- marketing.developer.dotdigital.com/reference/marketing-emails
- marketing.help.dotdigital.com/en/ (terms)
Checked by Mailfois against Dotdigital's documentation on 27 October 2026. Platforms rename things often: spotted something out of date? Email [email protected].
Other platforms
Mailchimp · Klaviyo · HubSpot Marketing Hub · Salesforce Marketing Cloud Engagement · Braze · Adobe Marketo Engage · Bloomreach Engagement · Brevo · Constant Contact · Campaign Monitor · Iterable · Resend