Mailfois
Dotdigital

Dotdigital email coding cheat sheet

The tags and rules you need to code an email or a module for Dotdigital: the unsubscribe link, personalisation with a fallback, the view-in-browser and address tags, editable regions and how to get your HTML in. Checked against Dotdigital's own documentation on 27 October 2026.

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: <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 ideaDotdigital calls itWorth knowing
One-off sendCampaignA 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 journeyProgramA 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 / entryProgram start conditionsThe rules deciding which contacts are enrolled onto a program, and when. Older articles call these program start rules.
Static groupListA 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 groupSegmentA rule-based group that rebuilds to include every contact currently matching. Segments rebuild on a refresh, so counts can lag behind live data.
Customer recordContactOne person, identified by email address or mobile number, with their data fields.
Custom fieldContact data fieldA custom field holding extra information for segmenting and personalisation. Fields are account-wide, not per list, every contact gets the field.
Behavioural eventEvent (Dotdigital Tag)A named customer action captured from your site or app, such as a product view.
Reusable blockCustom building blockA block designed once in EasyEditor and saved to reuse in later campaigns and pages.
TemplateTemplateA saved campaign design used as the starting point for new campaigns.
Personalisation languageLiquidThe markup language for personalisation, conditions and loops. Basic personalisation strings and Liquid are two separate syntaxes.
Fallback valueFallback valueAlternative text shown when a contact has no value in the field you’re personalising with.
A/B testSplit testSends variants to samples of your audience, optionally auto-sending the winner. Send time optimisation cannot be used on split test campaigns.
SuppressionSuppression listContacts stopped from receiving anything, unsubscribes, bounces and complaints. Suppression overrides list membership; removing someone from a list doesn’t suppress them.
TransactionalTransactional emailOrder 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 centrePreference centreA hosted page where contacts choose which marketing preferences they want.
Send-time optimisationSend time optimisationSends each contact their email when they’re most likely to open it.
ReportingAnalyticsCampaign, channel, contact and commerce performance.
Imported data tableInsight dataCustom 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 sendTriggered campaignA 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 liveDraft / ActivePrograms 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.
Do it in Mailfois. Ask Mailfois, your email marketing assistant, writes modules and whole templates for Dotdigital with these tags, fallbacks and editable regions already in place. Studio adds the unsubscribe and privacy links before you copy the code, and Brand Guard flags merge tags left without a fallback. How Ask Mailfois works

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

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

Code for Dotdigital without looking up the tags.

Start with Ask Mailfois