- 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, preferences and address tags
- 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 idea | Iterable calls it | Worth knowing |
|---|---|---|
| One-off send | Blast campaign | A campaign sent to one or more lists, immediately, scheduled, or recurring. You cannot convert a campaign between blast and triggered after creating it. |
| Automated journey | Journey | An automated sequence of messages and interactions timed to each individual user. Renamed from Workflow, the API still uses workflowId and /api/workflows. |
| Trigger / entry | Entry 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 group | Static list | A list whose membership only changes when you add or remove people yourself. |
| Dynamic group | Dynamic list | A 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 record | User profile | The stored record of one person, holding all fields and event history. Docs and UI mix “user”, “contact” and “subscriber” for the same thing. |
| Custom field | User profile field | An 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 event | Custom event | An 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 block | Snippet | A reusable block of content inserted into templates at send time. Stays linked, so editing it updates every template, unlike a copied template. |
| Template | Template | A 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 language | Handlebars | The templating language used to insert per-user values into messages. Only a subset of standard Handlebars is supported. Not Liquid or Django. |
| Fallback value | defaultIfEmpty helper | A 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 test | Experiment | An A/B test comparing a control campaign against one or more variants. Only A/B testing, a holdout group is a separate concept. |
| Suppression | Suppression list | A 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 capping | Frequency Management | Project settings limiting how many marketing messages a user receives per period. Caps are per channel and per message type, never one combined overall limit. |
| Transactional | Transactional message channel | A channel marked transactional, so messages ignore unsubscribes and frequency caps. Set at channel creation and cannot be changed afterwards. |
| Preference centre | Subscription preference center | A 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 optimisation | Send 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. |
| Reporting | Insights, Dashboard, Reports | Reporting is split across several named surfaces rather than one view. Dashboard is private to you; Reports are shared. |
| Imported data table | Catalog | An 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 send | API-triggered campaign | A 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 live | Draft mode / Published | Journeys are drafted then published; campaigns use Draft / Ready / Running. A published journey cannot be edited, switch back to Draft mode first. |
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
- support.iterable.com/hc/en-us/articles/206514205-Handlebars-Reference-Built-In-Merge-Tags
- support.iterable.com/hc/en-us/articles/205480365-Personalizing-Templates-with-Handlebars
- support.iterable.com/hc/en-us/articles/360044425931-Template-Options-for-Email-
- support.iterable.com/hc/en-us/articles/115002425483-Template-Editors-Overview
- support.iterable.com/hc/en-us/articles/4405798856212-Journeys-Overview (terms)
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