Skip to content

Locales in messages

After adding locales to your workspace, you can target users in different languages all within a single push notification.

Prerequisites

To edit and manage multi-language support, you must have the “Manage Multi-Language Settings” user permission. To add the locale to a message, you’ll need permissions for editing campaigns.

Using locales

To use locales in your messaging, compose a push campaign or Canvas, then complete the following:

  1. Add translation tags {% translation %} and {% endtranslation %} to wrap all text and image or link URLs to be translated.

    Push notification composer with translation tags added to the title and message fields.

  2. Save your message as a draft.
  3. Select Manage language and add your locales for the message using the dropdown.
  4. Select Download template, then fill in the translations within the CSV template.



  5. To upload the completed CSV template, select Upload translations.

    The "Multi-language messages" window with two locales selected and buttons to download a template or upload translations.

To update the translations, update the CSV and re-upload the file. This means any changes to the IDs or locales in the CSV will not automatically update in your message.

Preview your locales

In the Preview message as user dropdown within the Test tab, select Custom user and enter different languages to preview the message to check if your message translates as expected.

Frequently asked questions

Can I make a change to the translated copy in one of my locales?

Yes. First, make the edit in the CSV, then upload the file again to make a change to the translated copy.

Can I nest translation tags?

No.

Can I add HTML styling in the translation tags?

Yes, but be sure to check that the HTML styling is not translated with the content.

What validations or extra checks does Braze do?

HOW HELPFUL WAS THIS PAGE?
New Stuff!