Mailfois
Braze

Braze email coding cheat sheet

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

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 %}
  • 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 ideaBraze calls itWorth knowing
One-off sendCampaignA 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 journeyCanvasA multi-step, multi-channel journey with branching, delays and its own analytics.
Trigger / entryAction-Based / API-Triggered / Scheduled DeliveryHow 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 groupSegmentA rule-based group recalculated live from attributes, events and engagement. Not Twilio Segment the CDP. Membership also recalculates just before send.
Customer recordUser ProfileOne record holding a person’s identifiers, attributes, events, purchases, devices and message history.
Custom fieldCustom attributeA 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 eventCustom eventAn 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 blockContent BlockA 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.
TemplateEmail TemplateA saved, reusable email design any campaign or Canvas can use. HTML and drag-and-drop templates are not interchangeable, switching means rebuilding.
Personalisation languageLiquidShopify’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 valuedefault filterThe Liquid filter supplying text when an attribute is missing or empty. Fires on nil, empty or false, but not on whitespace.
A/B testA/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”.
SuppressionUnsubscribed status / email blocklistBlocking 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 cappingFrequency CappingWorkspace-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.
TransactionalTransactional 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 centrePreference centerA hosted page where users choose which subscription groups they want. Every new subscription group is added to the preference center automatically.
Send-time optimisationIntelligent TimingBraze predicts each user’s best send time within a window and delivers then. Previously Intelligent Delivery. Campaigns must launch roughly 48 hours ahead.
ReportingReport Builder and DashboardsReport 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 tableCatalogsStructured 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 sendAPI-Triggered DeliveryA 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 liveDraft / Active / Stopped / Archived / IdleThe 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.
Do it in Mailfois. Ask Mailfois, your email marketing assistant, writes modules and whole templates for Braze 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 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

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

Code for Braze without looking up the tags.

Start with Ask Mailfois