Before creating multilingual campaigns or passes, you need to configure your language settings in Brevo. This involves preparing your contact data and setting up your languages so that Brevo knows which version to send to each contact.

Step 1: Prepare your contact data

Create a contact attribute to store each contact's preferred language or region, for example LANGUAGE or COUNTRY_CODE. When you send your campaign or pass, it will automatically use the language or region defined in each contact's attribute.

➡️ To learn more about custom contact attributes, check our dedicated article Create and manage custom contact attributes.

Step 2: Set up your languages in Brevo

Before creating multilingual campaigns or passes, configure your language settings to define your communications default language and the contact attribute that determines language delivery.

Select your language attribute

Select the contact attribute created in step 1 to define it as the contact attribute that contains your contacts' preferred language:

1. Click the account drop-down and click Settings > Localization.
2. Click Set up languages.
3. Under Select attribute, choose the contact attribute that contains your contacts' language information from the dropdown menu.
   
4. Click Continue.

Set your default language

Your default language is the language in which you will write your campaigns or passes. It is also the fallback version that will be sent if a contact's language attribute is empty or doesn't match any of the languages you've added.

To set up your default language:

1. From the Default language dropdown, select your default language.
   
2. In the Default language value field, enter the exact value as it appears in your contact attribute for this language. For example, en-us, en, or EN.
3. Click Continue.

Add additional languages

1. Click + Add Language.
   
2. Select a language from the Language dropdown menu.
3. In the Language value field, enter the exact value as it appears in your contact attributes for this language. For example, fr-fr or es-sp.
   
4. Click Add language.
5. Repeat steps 1–4 to add all the languages you want to support.
6. Click Save.

Your languages are now configured and visible in your localization settings under Settings > Localization. You can view, edit, or delete languages from this page at any time.

⏭️ What's next?

• Translate and send email campaigns in multiple languages

🤔 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.