Newsletter localization

How it works

After you’ve set your language attribute, you can add one or more languages to a newsletter or messages in a broadcast workflow.

When you send a localized message, people whose language attribute matches one of your message’s languages will receive the localized version of your message matching their language attribute. Anybody whose language attribute doesn’t match a language in your message receives the Default message.

When you set up a broadcast workflow, you’ll localize every message in your workflow individually.

flowchart LR C[Multi-language
message] --> D{Does a person's language
attribute match a message?} D -->|no| H[Person gets
Default message] D -->|yes, lang=es| E[Person gets
Spanish message] D -->|yes, lang=fr| F[Person gets
French message] D -->|yes, lang=de| G[Person gets
German message]

Set up multi-language broadcast

You’ll repeat this process for each message in your broadcast workflow. The icon indicates that a message in your workflow contains multiple languages.

When you create a message with multiple languages, you should always begin by drafting your Default message. This is the message intended for anybody who doesn’t match another language, and should represent your “template” for other languages.

In the Workflow step of your broadcast:

  1. Drag a message into your workflow, and click to select it.
  2. Set a Name for your message, and click Add Content.
  3. Click Add language, select the languages you want to add, and click Add.
    Add languages to your newsletter
    Add languages to your newsletter
  4. Draft your Default message. This message should act as a “template” for your other languages.
  5. Add your content for your languages. Use the tabs at the top of the message to switch between languages.
    A newsletter with multiple languages
    A newsletter with multiple languages
  6. When you’re done, click Save & Next and finish setting up your newsletter.

 Create and style your Default message first!

If you plan to send email contents to a translation vendor, you’ll want to set up and export your Default message first, and then add languages when you receive them. Check out our best practices for help exporting email messages for your translation vendor.

Set up a multi-language newsletter

When you create a message with multiple languages, you should always begin by drafting your Default message. This is the message intended for anybody who doesn’t match another language, and should represent your “template” for other languages.

If you plan to send email contents to a translation vendor, you’ll want to set up and export your Default message first, and then add languages when you receive them. Check out our best practices for help exporting email messages for your translation vendor and the quickest way to add your multi-language content.

  1. Go to Broadcasts, select Newsletter, enter a Name for your newsletter, and then click Create Broadcast.
  2. Select who you want to send your newsletter to, a segmentA segment is a group of people in your audience that you want to target with campaigns, messages, etc. You can join groups of people manually, or by attribues and event data. of people or everyone in your workspace, and then click Save & Next.
  3. In the Content step, select the channel you want to send your message to, and then click to add Content.
  4. Click Add language, select the languages you want to add, and click Add.
    Add languages to your newsletter
    Add languages to your newsletter
  5. Draft your Default message. This message should act as a “template” for your other languages.
  6. Add your content for your languages. Use the tabs at the top of the message to switch between languages.
    A newsletter with multiple languages
    A newsletter with multiple languages
  7. When you’re done, click Save & Next and finish setting up your newsletter.

Delete a language from your newsletter

When composing your newsletter, you can remove languages that you add by mistake. Go to the tab for the language you want to remove and click .

Removing a language means that people bearing the language code in their localization attribute will receive the default message.

Remove a language from your content
Remove a language from your content

Set up an A/B test with localizations

You can set up multi-language newsletters with A/B test variants. When you do this, you’ll create your newsletter tests as you normally would, and then add languages for each variant in the test.

If you set up languages for each variant in your test, we’ll split users into the test before we check their language attribute(s). So, while your audience is split according to your settings, your languages might not be split evenly within, or across, variants.

Metrics for localized newsletters

When you send a message with multiple languages, we show metrics for each language. These metrics can help you make sure that your messages perform well in all of your audience’s languages.

An example newsletter with metrics in multiple languages
An example newsletter with metrics in multiple languages
Copied to clipboard!
Is this page helpful?