- Unsubscribe
<a href="{{${set_user_to_unsubscribed_url}}}">Unsubscribe</a> (replaces the older {{${unsubscribe_url}}})- First name
{{${first_name}}}(Liquid)- With a fallback
{{${first_name} | default: 'there'}}- Preferences
{{${preference_center_url}}}
The Braze unsubscribe link
Put this in the footer of every marketing email you code for Braze:
<a href="{{${set_user_to_unsubscribed_url}}}">Unsubscribe</a> (replaces the older {{${unsubscribe_url}}})
- The pre-send check flags a missing unsubscribe link; {{${email_footer}}} inserts the workspace footer.
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 Braze: first name with a fallback
Braze uses Liquid. A first name on its own:
{{${first_name}}}
With a fallback, so an empty field never shows a blank or a raw tag:
{{${first_name} | default: 'there'}}
Showing something only to some people (an if / else):
{% if ${first_name} %}Hi {{${first_name}}}{% else %}Hi there{% endif %}
View in browser, preferences and address tags
- Preferences:
{{${preference_center_url}}}
Making a coded template editable in Braze
No editable-region markup for coded email. Coded HTML lives in the HTML editor (code only); the drag-and-drop editor is a separate template type, and the two are not interchangeable.
<!-- Paste the module into the HTML editor; reuse it with an HTML Content Block, not a drag-and-drop one -->
Getting your HTML into Braze
Content > Email > Create email template > Upload file: a ZIP with one HTML file and a folder of the images it references. Or paste the code into the HTML editor of a campaign or template.
Limits worth knowing
- Email body must be under 400 KB to save; aim for under 102 KB to avoid Gmail clipping.
- Template ZIP: under 5 MB, fewer than 50 images, one HTML file.
- Turn on inline CSS under Sending Settings > Advanced for the widest client support.
- HTML event handler attributes are removed automatically.
What Braze calls things
Every platform has its own words for the same ideas. Braze's, in plain English:
| The idea | Braze calls it | Worth knowing |
|---|---|---|
| One-off send | Campaign | A single message on one channel sent to a chosen segment, once or on a schedule. “Scheduled delivery” also covers recurring sends, it doesn’t mean one-off. |
| Automated journey | Canvas | A multi-step, multi-channel journey with branching, delays and its own analytics. |
| Trigger / entry | Action-Based / API-Triggered / Scheduled Delivery | How and when someone qualifies for a campaign or enters a Canvas. An API-triggered campaign is not the same thing as an API campaign. |
| Dynamic group | Segment | A rule-based group recalculated live from attributes, events and engagement. Not Twilio Segment the CDP. Membership also recalculates just before send. |
| Customer record | User Profile | One record holding a person’s identifiers, attributes, events, purchases, devices and message history. |
| Custom field | Custom attribute | A trait you define and store on a user profile for segmenting and personalisation. Keys are case-sensitive, and Braze keeps no history of previous values. |
| Behavioural event | Custom event | An action a user took, logged with a timestamp and optional properties. Purchase events are separate, logging revenue as a custom event loses LTV reporting. |
| Reusable block | Content Block | A reusable snippet of copy or HTML stored centrally and inserted via a Liquid tag. Dragged into the drag-and-drop editor it is copied, so later edits stop propagating. |
| Template | Email Template | A saved, reusable email design any campaign or Canvas can use. HTML and drag-and-drop templates are not interchangeable, switching means rebuilding. |
| Personalisation language | Liquid | Shopify’s templating language, used to insert user data and logic into messages. Braze supports most but not all Shopify Liquid. It is not Handlebars. |
| Fallback value | default filter | The Liquid filter supplying text when an attribute is missing or empty. Fires on nil, empty or false, but not on whitespace. |
| A/B test | A/B test (variants, control group) | Sending competing versions to random splits to see which performs best. A control group records no opens or clicks, so it can never “win”. |
| Suppression | Unsubscribed status / email blocklist | Blocking happens via subscription state or the blocklist API; campaign exclusion uses AND NOT filters. There is no reusable suppression list object you can attach to a send. |
| Frequency capping | Frequency Capping | Workspace-wide rules limiting how many messages one user receives in a set period. Campaigns set to ignore caps also stop counting toward them by default. |
| Transactional | Transactional email (API campaign) | An SLA-backed, API-triggered email such as a receipt, sent outside marketing opt-in rules. Paid add-on with its own API key. Bypasses the Global Control Group. |
| Preference centre | Preference center | A hosted page where users choose which subscription groups they want. Every new subscription group is added to the preference center automatically. |
| Send-time optimisation | Intelligent Timing | Braze predicts each user’s best send time within a window and delivers then. Previously Intelligent Delivery. Campaigns must launch roughly 48 hours ahead. |
| Reporting | Report Builder and Dashboards | Report Builder is the flexible reporting surface; Dashboards are curated overviews. A separate “Report Builder (legacy)” still exists, check which one you’re in. |
| Imported data table | Catalogs | Structured non-user data such as products or stores, uploaded by CSV or API and read by Liquid. Storage only, you still need Liquid catalog tags to surface the data. |
| API-triggered send | API-Triggered Delivery | A campaign built in Braze but fired by your server. Webhook channel, API campaign, API-triggered campaign and /messages/send are four different things. |
| Draft vs live | Draft / Active / Stopped / Archived / Idle | The five statuses a campaign or Canvas moves through. There is no “Scheduled” status, scheduling is a delivery setting, not a state. |
What we couldn't confirm
We only list what Braze's documentation says. These points weren't clear from it, so test them in your account:
- No view-in-browser tag was found in the docs read.
- No postal address tag: the address is typed into the custom footer.
- The if/else example uses standard Liquid; Braze docs only show a single if.
Questions
What is the unsubscribe tag in Braze?
{{${set_user_to_unsubscribed_url}}} (replaces the older {{${unsubscribe_url}}}). The pre-send check flags a missing unsubscribe link; {{${email_footer}}} inserts the workspace footer.
How do I add a first name with a fallback in Braze?
Braze uses Liquid. A first name is {{${first_name}}}, and with a fallback: {{${first_name} | default: 'there'}}
How do I get a custom HTML email into Braze?
Content > Email > Create email template > Upload file: a ZIP with one HTML file and a folder of the images it references. Or paste the code into the HTML editor of a campaign or template.
Sources
- www.braze.com/docs/user_guide/personalization_and_dynamic_content/liquid/using_liquid/
- www.braze.com/docs/user_guide/message_building_by_channel/email/custom_email_footer/
- www.braze.com/docs/user_guide/channels/email/html_editor
- www.braze.com/docs/user_guide/message_building_by_channel/email/templates/html_email_template/
- www.braze.com/docs/user_guide/get_started/campaigns_and_canvases (terms)
Checked by Mailfois against Braze'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 · Adobe Marketo Engage · Bloomreach Engagement · Brevo · Constant Contact · Campaign Monitor · Dotdigital · Iterable · Resend