Use the Brevo Template Language to personalize your messages with contact or event-specific data, hide or display content to specific recipients, and adjust how values are formatted in your messages.

💬 Variables

Variables, also known as placeholders or merge tags, are tags that you can insert into your messages to personalize them. When you send a message, each variable is automatically replaced with the corresponding contact’s information.

In Brevo's template language, variables must be enclosed within double curly brackets, like {{ ... }} or {{...}}. They can be used for simple insertions or combined with conditional statements and filters for advanced personalization.

The Brevo Template Language supports different types of variables:

👤 Contact variables

Contact variables allow you to display data from your contacts' attributes, such as a contact's first name, in your messages. These variables are formatted as {{ contact.ATTRIBUTE }}, where you should replace ATTRIBUTE with the exact name of your contact attribute as it appears on the Contact attributes page in your Brevo account. You can use both default Brevo attributes and custom attributes.

Here are some examples of contact variables with three default Brevo attributes and one custom attribute:

➡️ To learn more about the different types of contact attributes available and how to create custom ones, check our dedicated articles:

• About contact attributes
• Create and manage contact attributes

🔗 Email link and preview variables

Email link and preview variables allow recipients to view your email in their browser, unsubscribe from your communications, and manage their preferences. These variables should be placed inside an HTML <a> tag, wrapping the text that will be displayed in the email.

The following email link and preview variables are available:

➡️ To learn more, check our dedicated articles:

• Insert a 'View in browser' link in your campaigns
• Insert an unsubscribe link in your campaigns
• Update your contacts details and preferences (profile update form)
• Create a custom double opt-in (DOI) email template for a sign-up form created in Brevo

📅 Date variables

Date variables allow you to insert a timestamp of the exact date and time an email was sent. The date is based on your Brevo account's timezone. If no timezone is set in your account, the variable will default to the current timestamp in UTC. 

The following date variable is available:

➡️ To learn more about adjusting the formatting of dates, check our dedicated article Modify the formatting of your placeholders with filters.

⚡ Event variables

Event variables allow you to display data from specific events triggered by a contact's actions, such as the price of their last purchased item or the name of the meeting they booked.

To identify event variables for your message, check your API call or event logs in Brevo. Here's an example of a typical JSON structure, where:

data is the root object containing the following properties: id → The cart ID total → The total cart amount currency → The currency type url → A link to the cart items is an array of products in the cart, each containing the following properties: name → Product name price → Product price url → Product page URL image → Product image URL

Event variables are formatted using double curly brackets. Each data in the JSON structure can be included in an event variable to personalize your messages:

{% for item in params.items %}
{{ item.name }}
{% endfor %}

🛢️ Data feed variables

Data feed variables allow you to personalize your marketing communications sent with Brevo with the latest information about products, customers, events, or any other relevant data from your external data source or API. Use them to automate and personalize your messages with real-time data. 

To identify data feed variables for your message, click the account dropdown and select Settings > Data management > Data feeds to check your source file structure on Brevo:

Data feed variables are formatted using double curly brackets. Depending on the complexity of your data feed structure, the format of your data feed variables varies: 

{% for item in feed.yoga_classes.following_classes %}
{{ item.class_name }}
{% endfor %}

🛒 Product feed variables

Product feed variables allow you to display a dynamic list of products from your online store, facilitating the creation of personalized recommendations. It contains product details like name, description, prices, images, and availability. Use it to showcase popular items, personalize recommendations, or maintain consistent product displays in your marketing campaigns.

Product feed variables are formatted using double curly brackets:

{{ feed.feedalias.products.variable }}

You should then replace:

• feedalias is the exact name of your product feed, matching the spelling and case as it appears on the Product feeds page.
• variable is the field's name in the API that contains the data you want to retrieve?.

Input	Description	Output
{{feed.mats_bestseller.products.imageUrl}}	Product image
{{feed.mats_bestseller.products.name}}	Product name	Non-slip yoga mat - 6mm
{{feed.mats_bestseller.products.url}}	Link to the product	https://thegreenyoga.com/non-slip/black-mat.html

Display all the elements using a for loop

Use a for loop to dynamically display all elements in an array. Instead of manually referencing each index, the loop iterates through the array and displays each item automatically. This is especially useful when the number of items in the array is unknown, such as a list of weekly blog posts or a receipt for purchased products.

For example, if we want to show the name of every item in the mats_bestseller product feed, the corresponding for loop would be:

{% for item in feed.mats_bestseller.products %}
{{ item.name }}
{% endfor %}

➡️ To learn more about for loops, check our dedicated article [Manual] Repeat a block of items in your emails using for loops.

📢 Conditional statements

👀 Conditional display (if statements)

Use an if statement to show or hide parts of your email based on each recipient’s data. This allows you to send a single email that dynamically adapts to different contacts, depending on specific conditions.

➡️ To learn more about if statement, check our dedicated article [Manual] Show or hide content in your emails using if statements.

🔁 Repeatable sections (for loops)

Use a for loop to dynamically display all elements in an array. Instead of manually referencing each index, the loop iterates through the array and displays each item automatically. This is especially useful when the number of items in the array is unknown, such as a list of weekly blog posts or a receipt for purchased products.

➡️ To learn more about for loops, check our dedicated article [Manual] Repeat a block of items in your emails using for loops.

🪄 Filters

Filters modify the output of a variable by transforming its value. They are placed inside the variable's double brackets and separated by a pipe |, e.g., {{ contact.FIRSTNAME|upper }}. You can also chain multiple filters together, with each filter applying its transformation to the result of the previous one.

Here are some examples of variables used together with filters to modify their output:

➡️ To learn more, check our dedicated article Modify the formatting of your placeholders with filters.

🤔 Have a question?

If you have a question, feel free to contact our support team by creating a ticket from your account. If you don't have an account yet, you can contact us here.

If you’re looking for help with a project using Brevo, we can match you with the right certified Brevo Agency partner.