12

Set up your localization attribute

Before you can set up multi-language messages, you need to store your audience’s language preferences as an attribute. You can tell us what that attribute is, and then use it to send people messages in their preferred language!

How it works

Before you can send localized messages, you need to go to Workspace Settings > Language settings and tell us what attributeA key-value pair that you associate with a person or an object—like a person’s name, the date they were created in your workspace, or a company’s billing date etc. Use attributes to target people and personalize messages. Attributes are analogous to traits in Data Pipelines. stores your audience’s language preferences. This attribute must store values we support, meaning they’re either:

• a two letter language code, like en for English
• a four-letter language and region code, separated by a dash, like en-US for English speakers in the United States.

We’ll match your customers’ attribute values to the corresponding languages for your message. If a person’s language attribute doesn’t match one of the languages in your message, they’ll receive the Default message.

If you already store languages in a format that doesn’t fit our standards, you may be able to convert your current value(s) with liquidA syntax that supports variables, letting you personalize messages for your audience. For example, if you want to reference a person’s first name, you might use the variable {{customer.first_name}}. or JavaScript.

Set your language attribute

When you add a language attribute, we assume that values fit our list of supported languages. If you already have a “language attribute”, but it doesn’t use our supported values, you may want to create a new attribute and set up a campaign to convert your existing attribute to our supported formats.

Before you can send localized messages, you need to go to Workspace Settings > Language settings and tell us what attributeA key-value pair that you associate with a person or an object—like a person’s name, the date they were created in your workspace, or a company’s billing date etc. Use attributes to target people and personalize messages. Attributes are analogous to traits in Data Pipelines. stores your audience’s language preferences. This attribute must store values we support, meaning they’re either:

• a two letter language code, like en for English
• a four-letter language and region code, separated by a dash, like en-US for English speakers in the United States.

To set your workspace’s language attribute:

1. Go to Settings > Workspace Settings.
2. Find Language Settings and click Get Started.
3. Enter the name of the attribute representing your audience’s language.

Convert language attributes to our standards

If you already store your audience’s language preference in a format that doesn’t fit ISO-3166-1 (alpha 2) or IETF standards, you can set up a campaign to reformat your language attribute.

Create a new attribute to store the reformatted preference, in case integrations continue to add or update people with a language preference that you need to reformat.

1. Create a segmentA group of people who match a series of conditions. People enter and exit the segment automatically when they match or stop matching conditions. containing people with your original language attribute.
2. Create a campaign. Click “Segment change” as the trigger type. On the Trigger page:
   1. Click Choose segment.
   2. Choose the segment you just created from the dropdown.
   3. Click Save condition.

      

      
   4. Click Save & Next.
3. In your Workflow, drag Create or update person onto the canvas.
   1. Give the action a Name, and click Add Details.
   2. Under attribute, type the name of the language attribute you set in Language settings.
   3. Select Liquid or JavaScript, and write an expression to convert or map languages. We’ve provided some examples below.

      

      
   4. Under Sample Data, click next to the original attribute.
   5. Set the value to Remove attribute. This removes the original language attribute and removes the person from the segment you set up in the first step.

Use liquid to convert language values

When you use the Create or Update Person action, you can set and modify attributes using liquidA syntax that supports variables, letting you personalize messages for your audience. For example, if you want to reference a person’s first name, you might use the variable {{customer.first_name}}.. The liquid expression you use to map your old language attribute to your new one depends on your current language format, but we’ve provided some ideas below.

If you store languages with an underscore instead of a dash (e.g. en_US instead of en-US), you can replace the underscore easily with replace:

// assume input en_us
{{ customer.language | replace: "_", "-" }}
// outputs en-us 

If you store languages without a delimiter, you can add one by slicing your original language attribute:

// assume input enUS
{{ customer.language | slice: 2 }}-{{customer.language | slice: 3, 2}}
// output 

Or, if you store languages as full names, you may need to map some of them. You can do this with condtitions:

// assume languages are english, french, and german
{% if customer.language == "German" %}
    de
    // output for german
{% else %}
    {{customer.language | slice: 2, 2}}
    // for french and english, use the first two letters of language code
{% end %}

Use JavaScript to convert language values

When you use the Create or Update Person action, you can set and modify attributes using JavaScript. The liquid expression you use to map your old language attribute to your new one depends on your current language format, but we’ve provided some ideas below.

If you store languages with an underscore instead of a dash (e.g. en_US instead of en-US), you can replace the underscore easily with replace:

// assume `language` attribute formatted en_us
return customer.language.replace("_", "-");
// outputs en-us 

If you store languages without a delimiter, you can add one by slicing your original language attribute:

// assume `language` attribute formatted enUS
return customer.language.slice(0, 2) + "-" + customer.language.slice(2);
// output 

Or, if you store languages as full names, you may need to map some of them. You can do this with condtitions:

// assume languages are english, french, and german
if (customer.language == "German") {
    return de;
    // output for german
} else {
    customer.language.slice(0, 2);
    // for french and english, use the first two letters of language code
}

Supported languages and locales

You must format the values of your language attribute as two-letter language codes with an optional two-letter region code separated by a dash, like en or en-US.

Language attributes are not case sensitive, but language-region codes must be separated by a dash. For example, both es-MX and es-mx represent Spanish formatted for speakers in Mexico.

These codes come from the ISO-3166-1 (alpha 2) and IETF standards respectively. If you’re looking for a language or locale that we don’t support, let us know!