Mailfois
Iterable

Iterable email coding cheat sheet

The tags and rules you need to code an email or a module for Iterable: 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 Iterable's own documentation on 27 October 2026.

Unsubscribe
<a href="{{unsubscribeUrl}}">Unsubscribe</a>
First name
{{firstName}} (Handlebars)
With a fallback
{{defaultIfEmpty firstName "there"}}
View in browser
<a href="{{viewInBrowserUrl}}">View in browser</a>
Preferences
<a href="{{hostedUnsubscribeUrl}}">Manage preferences</a>
Postal address
{{physicalAddress}}

The Iterable unsubscribe link

Put this in the footer of every marketing email you code for Iterable:

<a href="{{unsubscribeUrl}}">Unsubscribe</a>
  • Marketing templates must include an unsubscribe link ({{unsubscribeUrl}}, {{unsubscribeMessageTypeUrl}} or {{hostedUnsubscribeUrl}}).
  • Include {{physicalAddress}} for CAN-SPAM; the Auto-append Unsubscribe Block setting adds one to marketing emails.

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 Iterable: first name with a fallback

Iterable uses Handlebars. A first name on its own:

{{firstName}}

With a fallback, so an empty field never shows a blank or a raw tag:

{{defaultIfEmpty firstName "there"}}

Showing something only to some people (an if / else):

<!--{{#if firstName}}-->Hi {{firstName}}<!--{{else}}-->Hi there<!--{{/if}}-->
  • View in browser: <a href="{{viewInBrowserUrl}}">View in browser</a>
  • Preferences: <a href="{{hostedUnsubscribeUrl}}">Manage preferences</a>
  • Postal address: {{physicalAddress}}

Making a coded template editable in Iterable

No editable-region markup. Coded templates use the Side by Side (code plus preview) or WYSIWYG editor; in Drag and Drop templates, custom HTML goes only in an HTML block.

<!-- Paste into the Side by Side editor, or into an HTML block in a Drag and Drop template -->

Getting your HTML into Iterable

Create an email template and paste or load the HTML into the Side by Side editor (or the WYSIWYG editor's Source view).

Limits worth knowing

  • Wrap block helpers in HTML comments in the source, as in the conditional above.
  • Converting CSS to inline styles is a per-template setting in Preferences.
  • Drag and Drop templates cannot be switched to the WYSIWYG or Side by Side editors.

What Iterable calls things

Every platform has its own words for the same ideas. Iterable's, in plain English:

The ideaIterable calls itWorth knowing
One-off sendBlast campaignA campaign sent to one or more lists, immediately, scheduled, or recurring. You cannot convert a campaign between blast and triggered after creating it.
Automated journeyJourneyAn automated sequence of messages and interactions timed to each individual user. Renamed from Workflow, the API still uses workflowId and /api/workflows.
Trigger / entryEntry source (Start tile)What adds users: an event, a schedule, an API call, or another journey. “Schedule” re-adds existing list members; “subscribe to list” only catches new ones.
Static groupStatic listA list whose membership only changes when you add or remove people yourself.
Dynamic groupDynamic listA list built from a Segmentation query that updates itself as users match. There is no saved “Segment” object, you save the query as a list.
Customer recordUser profileThe stored record of one person, holding all fields and event history. Docs and UI mix “user”, “contact” and “subscriber” for the same thing.
Custom fieldUser profile fieldAn attribute on a profile; custom ones sit under dataFields in the API. A field’s data type is permanent once set and cannot be changed.
Behavioural eventCustom eventAn action a user took, tracked against their profile and usable in segmentation. Event properties are not stored on the profile and can affect your bill.
Reusable blockSnippetA reusable block of content inserted into templates at send time. Stays linked, so editing it updates every template, unlike a copied template.
TemplateTemplateA reusable blueprint of layout, style and content used by campaigns and journeys. A campaign takes a copy, so later template edits do not reach it.
Personalisation languageHandlebarsThe templating language used to insert per-user values into messages. Only a subset of standard Handlebars is supported. Not Liquid or Django.
Fallback valuedefaultIfEmpty helperA Handlebars helper showing fallback text when a field is empty or missing. Other helpers on missing fields can fail the template and block the send.
A/B testExperimentAn A/B test comparing a control campaign against one or more variants. Only A/B testing, a holdout group is a separate concept.
SuppressionSuppression listA list of users excluded from the campaigns and journeys it is applied to. Non-global lists only apply where manually attached. Ten global maximum per project.
Frequency cappingFrequency ManagementProject settings limiting how many marketing messages a user receives per period. Caps are per channel and per message type, never one combined overall limit.
TransactionalTransactional message channelA channel marked transactional, so messages ignore unsubscribes and frequency caps. Set at channel creation and cannot be changed afterwards.
Preference centreSubscription preference centerA page where users manage which channels, message types and lists they receive. With a custom center, Iterable unsubscribes nobody, your code must call the API.
Send-time optimisationSend Time Optimization (STO)Iterable picks each recipient’s best send hour from past engagement. Needs ~3 months of data per user. Quiet Hours and sendAt override it.
ReportingInsights, Dashboard, ReportsReporting is split across several named surfaces rather than one view. Dashboard is private to you; Reports are shared.
Imported data tableCatalogAn Iterable-hosted table of product or content data, queried at send time. Paid add-on. Collections only search fields whose data type is explicitly set.
API-triggered sendAPI-triggered campaignA campaign sent to one user when you call an Iterable target endpoint. Iterable webhooks are outbound only, they cannot receive calls to trigger sends.
Draft vs liveDraft mode / PublishedJourneys are drafted then published; campaigns use Draft / Ready / Running. A published journey cannot be edited, switch back to Draft mode first.
Do it in Mailfois. Ask Mailfois, your email marketing assistant, writes modules and whole templates for Iterable 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 Iterable?

{{unsubscribeUrl}}. Marketing templates must include an unsubscribe link ({{unsubscribeUrl}}, {{unsubscribeMessageTypeUrl}} or {{hostedUnsubscribeUrl}}).

How do I add a first name with a fallback in Iterable?

Iterable uses Handlebars. A first name is {{firstName}}, and with a fallback: {{defaultIfEmpty firstName "there"}}

How do I add a view-in-browser link in Iterable?

Use {{viewInBrowserUrl}}.

How do I get a custom HTML email into Iterable?

Create an email template and paste or load the HTML into the Side by Side editor (or the WYSIWYG editor's Source view).

Sources

Checked by Mailfois against Iterable'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 · Dotdigital · Resend

Code for Iterable without looking up the tags.

Start with Ask Mailfois