Skip to main content

Lokalise Vantage: Braze integration

Learn how to connect Braze to Lokalise Vantage, translate campaigns, canvases, and email templates, and send localized content back to Braze.

Written by Ilya Krukowski

This article covers only the Braze integration for Lokalise Vantage. To learn about Braze app for Lokalise Expert, refer to the Braze article.

The Braze integration in Lokalise Vantage allows you to import content directly from Braze, translate it using your Vantage workflows, and send it back when translations are ready.

Instead of exporting and importing content manually, you can connect your Braze workspace, select the content you want to localize, and manage translation and review in Vantage.

Once imported, the content follows the same workflow as other Vantage projects, including translation assets, AI-powered translation, optional human review, and export back to Braze.

What you can localize with the Braze integration

The Braze integration supports the following content types:

  • Campaigns

  • Canvases

  • Email templates

These are the content sources available when browsing Braze content from Vantage.

The integration also supports content created with Braze's drag-and-drop message builder.

Note: Examples in this guide may use a single content type for clarity, but the workflow is the same for campaigns, canvases, and email templates.

Prerequisites

Before connecting Braze to Vantage, make sure your Braze workspace is configured correctly. This includes:

  • creating and configuring a Braze API key

  • fetching your Braze server region

  • preparing the content you want to localize

  • enabling multilingual setup in Braze

Braze permissions and API key

To connect Lokalise Vantage to Braze, you’ll need:

  • A Braze REST API key with permission to read and update Campaigns, Canvases, and Email Templates

  • Your Braze server region (e.g., US-01, EU-01)

View screenshot with API key permissions

Enable multilingual setup in Braze

Braze’s multi-language functionality is currently in early access. It means your team must contact your Braze account manager to have multi-language support activated for your workspace (Lokalise cannot enable it on your behalf).

For Lokalise to fetch your Braze content:

  • The message (campaign, canvas, email template) must have multilanguage support enabled in Braze

  • Every language appears in Braze as a separate language variant of the same message

  • If multilanguage isn’t enabled for a specific item, it won’t show up in the Lokalise app at all.

  • Lokalise can update the localized language variants, but it cannot modify the original base-language version of your content.

Prepare content for translation in Braze

To make content available for translation, your Braze message must use translation tags around the text you want Lokalise to capture. Each translatable block must be wrapped in Braze translation tags and include a unique ID, for example:

{% translation 1 %}Test message.{% endtranslation %}

Translation tag IDs do not have to be numbers only. You can use numbers, letters, and underscores. For example:

{% translation 1 %}Test message.{% endtranslation %}
{% translation header %}Welcome!{% endtranslation %}
{% translation email_intro_1 %}Thanks for joining us.{% endtranslation %}

Keep in mind:

  • The translation tags must appear at the beginning and end of each translatable content block.

  • Each translation block must use its own unique ID.

  • If translation tags are missing, Lokalise may not detect the content for import and translation.

  • You do not need to wrap every individual text element in its own translation tag.

  • In many cases, it is more practical to wrap a larger section, such as a full email or HTML document.

    • Lokalise will then parse the HTML and create smaller translation segments automatically.

    • This approach can save significant setup time and reduce manual work for marketers and translators.

Create a Lokalise Vantage project with Braze integration

Step 1: Create a new project

Open Lokalise Vantage and click New project.

Step 2: Choose Braze as the content source

In the content source step, select Connect to your tool > Braze.

Step 3: Connect your Braze workspace

Enter the required Braze connection details:

  • API key

  • Server region

After entering the details, continue to the next step.

Step 4: Configure project details

Set up the basic project information:

  • Project name

  • Base language

  • Target languages

You can add more target languages later if needed.

Step 5: Select Braze content

Choose the Braze content you want to localize. You will see a list of available Braze items. Select one or more items using the checkboxes.

To find the right content faster, you can:

  • filter by content type

  • filter by date

  • use search

Step 6: Add glossary terms

Optionally, add glossary terms that should be applied during translation. These terms help Vantage keep terminology consistent across translated Braze content.

Step 7: Choose the workflow

Select how the content should be translated:

  • Instant AI translation — Vantage translates the content using AI only.

  • AI + human review — Vantage translates the content with AI, then routes content for review based on your review settings.

Click Start AI translation. Vantage will import the selected Braze content and start the translation workflow automatically.

Import more content from Braze

You can import additional Braze content into an existing Vantage project from the Editor.

To import more content:

  1. Open the project in Vantage.

  2. Go to the Editor.

  3. In the left panel, click Import from Braze.

  4. Select the Braze content you want to import.

  5. Use search or filters if needed.

  6. Click Import.

The imported content will be added to the project and processed using the project workflow.

Send translated content back to Braze

When translations are ready, you can send them back to Braze from the Editor. To export translated content:

  1. Open the project in Vantage.

  2. Go to the Editor.

  3. Click Send to Braze in the top menu.

  4. Select the content you want to export.

  5. Click Next.

  6. Choose which languages to send:

    • keep All languages enabled to export all target languages

    • or disable it and select specific target languages

  7. Click Send.

Vantage will send the selected translated content back to Braze.

Known limitations

The Braze integration currently has the following limitations:

  • Content Blocks are not supported yet.

  • Liquid code support is limited. More complex emails that rely heavily on Liquid may not appear or process as expected in Vantage.

Troubleshooting tips

If your Braze content does not appear in Vantage or no translatable text is imported, check the following.

Multilingual setup is not enabled

If you get an error while setting up or using the Braze integration, check that the required Braze setup steps are complete.

Most setup issues happen when multilingual support is not enabled in Braze or when the content is not prepared for translation with Liquid translation tags.

Content is not prepared for translation

Make sure the text you want to translate is wrapped in Braze translation tags:

{% translation header %} Welcome! {% endtranslation %}

If translation tags are missing, Vantage cannot detect translatable content and the import will fail.

Translation tag IDs are not unique

Each translation block must have a unique ID within the same message. For example, avoid using the same ID for multiple blocks:

{% translation text %} Header text {% endtranslation %}  {% translation text %} Body text {% endtranslation %}

Instead, use semantic IDs that describe the content:

{% translation header %} Header text {% endtranslation %}  {% translation body_intro %} Body text {% endtranslation %}

This makes the content easier to manage and helps Vantage process the translation blocks correctly.

Related Articles
Did this answer your question?