Mailfois
Brevo

Brevo email coding cheat sheet

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

Unsubscribe
<a href="{{ unsubscribe }}">Unsubscribe</a>
First name
{{ contact.FIRSTNAME }} (Brevo Template Language)
With a fallback
{{ contact.FIRSTNAME|default:"there" }}
View in browser
<a href="{{ mirror }}">View in browser</a>
Preferences
<a href="{{ update_profile }}">Manage preferences</a>

The Brevo unsubscribe link

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

<a href="{{ unsubscribe }}">Unsubscribe</a>
  • The unsubscribe link is mandatory in marketing emails; if removed, Brevo restores it when sending.
  • With the HTML editor, the custom unsubscribe page is chosen in the campaign creation flow, not in the design.

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

Brevo uses Brevo Template Language. A first name on its own:

{{ contact.FIRSTNAME }}

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

{{ contact.FIRSTNAME|default:"there" }}

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

{% if contact.FIRSTNAME %}Hi {{ contact.FIRSTNAME }}{% else %}Hi there{% endif %}
  • View in browser: <a href="{{ mirror }}">View in browser</a>
  • Preferences: <a href="{{ update_profile }}">Manage preferences</a>

Making a coded template editable in Brevo

No editable-region markup for coded email. Emails made in the HTML editor (Code your own) are edited as code.

<!-- Paste the whole email into Code your own > Paste your code -->

Getting your HTML into Brevo

In the campaign's Design step choose Code your own, paste your HTML and save. It can then be saved as a template (Actions > Save as template).

Limits worth knowing

  • Conditional statements work in email only; filters in email and SMS.
  • Variables are HTML-escaped unless wrapped in {% autoescape off %}.

What Brevo calls things

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

The ideaBrevo calls itWorth knowing
One-off sendEmail campaignOne email sent to many recipients at once, such as a newsletter.
Automated journeyAutomationA sequence of automated steps and emails running when a contact meets your conditions.
Trigger / entryEntry pointThe condition or action starting a contact on an automation.
Static groupListA fixed group of contacts used as the sending target for campaigns.
Dynamic groupSegmentA saved filter grouping contacts by shared characteristics like location or purchase history.
Customer recordContactOne person in your database, with attributes, list memberships and message history.
Custom fieldContact attributeA field storing information about a contact, usable in personalisation. Distinct from transactional attributes, which store order data.
Behavioural eventCustom eventAn action you define and send to Brevo to record behaviour and start automations. Brevo tracks nothing automatically, events must be sent via tracker or API.
Reusable blockSaved sectionA block of email design saved once and dragged into other emails. Only whole sections can be saved, single images or text blocks cannot.
TemplateEmail templateA preset design reused across campaigns, automations or transactional messages.
Personalisation languageBrevo Template LanguageDouble-curly-brace syntax, like {{contact.FIRSTNAME}}, inserting each contact’s data.
Fallback valuedefault filterA template-language filter supplying stand-in text when an attribute is empty.
A/B testA/B testSends two versions to sub-groups to see which performs better.
SuppressionBlocklistContacts excluded from a given channel; unsubscribes are automatically blocklisted. Per channel, blocked for email may still receive SMS.
Frequency cappingFrequency capAccount-wide sending cadence settings capping marketing emails per contact per period. Frequency cap covers campaigns; “email overload prevention” covers classic automations.
TransactionalTransactional emailA one-to-one system email sent via Brevo SMTP or API. Ignores marketing unsubscribes and frequency caps by design.
Preference centreUpdate profile formA form letting contacts change their details and preferences instead of unsubscribing.
Send-time optimisationSend at best timeCalculates the best send time per recipient based on past engagement. The glossary still says “Send Time Optimization”, both names appear in live docs.
ReportingStatisticsOpens, clicks, bounces and conversions per campaign or automation.
API-triggered sendTransactional email APITriggers an individual send from your code. Webhooks notify your systems of events.
Draft vs liveDraft / Active / PausedAutomations sit as drafts until activated; campaigns go draft → scheduled → sent.

What we couldn't confirm

We only list what Brevo's documentation says. These points weren't clear from it, so test them in your account:

  • An HTML block in the Drag & Drop editor for pasting a single module.
  • No postal address tag found; ZIP upload of images not confirmed.
  • The if/else syntax was confirmed from the help centre summary, not read in full.
Do it in Mailfois. Ask Mailfois, your email marketing assistant, writes modules and whole templates for Brevo 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 Brevo?

{{ unsubscribe }}. The unsubscribe link is mandatory in marketing emails; if removed, Brevo restores it when sending.

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

Brevo uses Brevo Template Language. A first name is {{ contact.FIRSTNAME }}, and with a fallback: {{ contact.FIRSTNAME|default:"there" }}

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

Use {{ mirror }}.

How do I get a custom HTML email into Brevo?

In the campaign's Design step choose Code your own, paste your HTML and save. It can then be saved as a template (Actions > Save as template).

Sources

Checked by Mailfois against Brevo'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 · Constant Contact · Campaign Monitor · Dotdigital · Iterable · Resend

Code for Brevo without looking up the tags.

Start with Ask Mailfois