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 Settings > Workspace Settings > Localization and tell us what attributeA key-value pair that you associate with a person—like their name, the date they were created in your workspace, etc. Use attributes to target people and personalize messages. 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.

When you go to send a message, we’ll match this attribute to the correct language 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.

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

Your language attribute can be any attribute in your workspace. The values for this attribute must be simple strings (not nested within an object), and formatted as either:

  • two letter language codes (defined by ISO-3166-1 alpha 2 standard), like es or en representing Spanish and English respectively.
  • four-letter IETF language-region codes separated by a dash, like es-mx representing Spanish language speakers in Mexico.

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.
Set your localization settings
Set your localization settings

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.

You may want to 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 data-driven 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. On the Trigger page:
    1. Click A person meets conditions
    2. Click Add segment condition and pick the segment you set in earlier steps.
    3. Click Next.
      Select a segment containing people with your original language attribute
      Select a segment containing people with your original language attribute
  3. In the Workflow step, drag Create or update person into your workflow.
  4. Give the action a Name, and click Add Details.
  5. Find the attribute you want to convert under Sample Data, and click Add.
  6. In the Value field, select Liquid or JavaScript, and write an expression to convert or map languages. We’ve provided some examples below.
  7. Select the original attribute in the Sample data again, and 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

Your language attribute’s values must be formatted as a two letter language code with an optional two-letter region code separated by a dash. For example, you might use en for English or en-US for English speakers in the United States.

Language attributes are not case sensitive, but language-region codes must be separated by a dash. For example, both es-MX and es-mx both 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!

Language/LocaleCode
Afrikaansaf
Afrikaans (South Africa)af-ZA
Amharic (Ethiopia)am-ET
Arabicar
Arabic (U.A.E.)ar-AE
Arabic (Bahrain)ar-BH
Arabic (Algeria)ar-DZ
Arabic (Egypt)ar-EG
Arabic (Iraq)ar-IQ
Arabic (Jordan)ar-JO
Arabic (Kuwait)ar-KW
Arabic (Lebanon)ar-LB
Arabic (Libya)ar-LY
Arabic (Morocco)ar-MA
Arabic (Oman)ar-OM
Arabic (Qatar)ar-QA
Arabic (Saudi Arabia)ar-SA
Arabic (Syria)ar-SY
Arabic (Tunisia)ar-TN
Arabic (Yemen)ar-YE
Mapudungun (Chile)arn-CL
Assamese (India)as-IN
Azeriaz
Azeri (Cyrillic) (Azerbaijan)az-Cyrl-AZ
Azeri (Latin) (Azerbaijan)az-Latn-AZ
Bashkir (Russia)ba-RU
Belarusianbe
Belarusian (Belarus)be-BY
Bulgarianbg
Bulgarian (Bulgaria)bg-BG
Bengali (Bangladesh)bn-BD
Bengali (India)bn-IN
Tibetan (People's Republic of China)bo-CN
Breton (France)br-FR
Bosnian (Cyrillic) (Bosnia and Herzegovina)bs-Cyrl-BA
Bosnian (Latin) (Bosnia and Herzegovina)bs-Latn-BA
Catalanca
Catalan (Catalan)ca-ES
Corsican (France)co-FR
Czechcs
Czech (Czech Republic)cs-CZ
Welsh (United Kingdom)cy-GB
Danishda
Danish (Denmark)da-DK
Germande
German (Austria)de-AT
German (Switzerland)de-CH
German (Germany)de-DE
German (Liechtenstein)de-LI
German (Luxembourg)de-LU
Lower Sorbian (Germany)dsb-DE
Divehidv
Divehi (Maldives)dv-MV
Greekel
Greek (Greece)el-GR
Englishen
English (Caribbean)en-029
English (Australia)en-AU
English (Belize)en-BZ
English (Canada)en-CA
English (United Kingdom)en-GB
English (Ireland)en-IE
English (India)en-IN
English (Jamaica)en-JM
English (Malaysia)en-MY
English (New Zealand)en-NZ
English (Republic of the Philippines)en-PH
English (Singapore)en-SG
English (Trinidad and Tobago)en-TT
English (United States)en-US
English (South Africa)en-ZA
English (Zimbabwe)en-ZW
Spanishes
Spanish (Argentina)es-AR
Spanish (Bolivia)es-BO
Spanish (Chile)es-CL
Spanish (Colombia)es-CO
Spanish (Costa Rica)es-CR
Spanish (Dominican Republic)es-DO
Spanish (Ecuador)es-EC
Spanish (Spain)es-ES
Spanish (Guatemala)es-GT
Spanish (Honduras)es-HN
Spanish (Mexico)es-MX
Spanish (Nicaragua)es-NI
Spanish (Panama)es-PA
Spanish (Peru)es-PE
Spanish (Puerto Rico)es-PR
Spanish (Paraguay)es-PY
Spanish (El Salvador)es-SV
Spanish (United States)es-US
Spanish (Uruguay)es-UY
Spanish (Venezuela)es-VE
Estonianet
Estonian (Estonia)et-EE
Basqueeu
Basque (Basque)eu-ES
Persianfa
Persian (Iran)fa-IR
Finnishfi
Finnish (Finland)fi-FI
Filipino (Philippines)fil-PH
Faroesefo
Faroese (Faroe Islands)fo-FO
Frenchfr
French (Belgium)fr-BE
French (Canada)fr-CA
French (Switzerland)fr-CH
French (France)fr-FR
French (Luxembourg)fr-LU
French (Principality of Monaco)fr-MC
Frisian (Netherlands)fy-NL
Irish (Ireland)ga-IE
Scottish Gaelic (United Kingdom)gd-GB
Galiciangl
Galician (Galician)gl-ES
Alsatian (France)gsw-FR
Gujaratigu
Gujarati (India)gu-IN
Hausa (Latin) (Nigeria)ha-Latn-NG
Hebrewhe
Hebrew (Israel)he-IL
Hindihi
Hindi (India)hi-IN
Croatianhr
Croatian (Latin) (Bosnia and Herzegovina)hr-BA
Croatian (Croatia)hr-HR
Upper Sorbian (Germany)hsb-DE
Hungarianhu
Hungarian (Hungary)hu-HU
Armenianhy
Armenian (Armenia)hy-AM
Indonesianid
Indonesian (Indonesia)id-ID
Igbo (Nigeria)ig-NG
Yi (People's Republic of China)ii-CN
Icelandicis
Icelandic (Iceland)is-IS
Italianit
Italian (Switzerland)it-CH
Italian (Italy)it-IT
Inuktitut (Syllabics) (Canada)iu-Cans-CA
Inuktitut (Latin) (Canada)iu-Latn-CA
Japaneseja
Japanese (Japan)ja-JP
Georgianka
Georgian (Georgia)ka-GE
Kazakhkk
Kazakh (Kazakhstan)kk-KZ
Greenlandic (Greenland)kl-GL
Khmer (Cambodia)km-KH
Kannadakn
Kannada (India)kn-IN
Koreanko
Korean (Korea)ko-KR
Konkanikok
Konkani (India)kok-IN
Kyrgyzky
Kyrgyz (Kyrgyzstan)ky-KG
Latinla
Luxembourgish (Luxembourg)lb-LU
Lao (Lao P.D.R.)lo-LA
Lithuanianlt
Lithuanian (Lithuania)lt-LT
Latvianlv
Latvian (Latvia)lv-LV
Maori (New Zealand)mi-NZ
Macedonianmk
Macedonian (Former Yugoslav Republic of Macedonia)mk-MK
Malayalam (India)ml-IN
Mongolianmn
Mongolian (Cyrillic) (Mongolia)mn-MN
Mongolian (Traditional Mongolian) (People's Republic of China)mn-Mong-CN
Mohawk (Canada)moh-CA
Marathimr
Marathi (India)mr-IN
Malayms
Malay (Brunei Darussalam)ms-BN
Malay (Malaysia)ms-MY
Maltese (Malta)mt-MT
"Norwegian, Bokmål (Norway)"nb-NO
Nepali (Nepal)ne-NP
Dutchnl
Dutch (Belgium)nl-BE
Dutch (Netherlands)nl-NL
"Norwegian, Nynorsk (Norway)"nn-NO
Norwegianno
Sesotho sa Leboa (South Africa)nso-ZA
Occitan (France)oc-FR
Oriya (India)or-IN
Punjabipa
Punjabi (India)pa-IN
Polishpl
Polish (Poland)pl-PL
Dari (Afghanistan)prs-AF
Pashto (Afghanistan)ps-AF
Portuguesept
Portuguese (Brazil)pt-BR
Portuguese (Portugal)pt-PT
K'iche (Guatemala)qut-GT
Quechua (Bolivia)quz-BO
Quechua (Ecuador)quz-EC
Quechua (Peru)quz-PE
Romansh (Switzerland)rm-CH
Romanianro
Romanian (Romania)ro-RO
Russianru
Russian (Russia)ru-RU
Kinyarwanda (Rwanda)rw-RW
Sanskritsa
Sanskrit (India)sa-IN
Yakut (Russia)sah-RU
Sami (Northern) (Finland)se-FI
Sami (Northern) (Norway)se-NO
Sami (Northern) (Sweden)se-SE
Sinhala (Sri Lanka)si-LK
Slovaksk
Slovak (Slovakia)sk-SK
Sloveniansl
Slovenian (Slovenia)sl-SI
Sami (Southern) (Norway)sma-NO
Sami (Southern) (Sweden)sma-SE
Sami (Lule) (Norway)smj-NO
Sami (Lule) (Sweden)smj-SE
Sami (Inari) (Finland)smn-FI
Sami (Skolt) (Finland)sms-FI
Albaniansq
Albanian (Albania)sq-AL
Serbiansr
Serbian (Cyrillic) (Bosnia and Herzegovina)sr-Cyrl-BA
Serbian (Cyrillic) (Serbia and Montenegro (Former))sr-Cyrl-CS
Serbian (Cyrillic) (Montenegro)sr-Cyrl-ME
Serbian (Cyrillic) (Serbia)sr-Cyrl-RS
Serbian (Latin) (Bosnia and Herzegovina)sr-Latn-BA
Serbian (Latin) (Serbia and Montenegro (Former))sr-Latn-CS
Serbian (Latin) (Montenegro)sr-Latn-ME
Serbian (Latin) (Serbia)sr-Latn-RS
Swedishsv
Swedish (Finland)sv-FI
Swedish (Sweden)sv-SE
Kiswahilisw
Kiswahili (Kenya)sw-KE
Syriacsyr
Syriac (Syria)syr-SY
Tamilta
Tamil (India)ta-IN
Telugute
Telugu (India)te-IN
Tajik (Cyrillic) (Tajikistan)tg-Cyrl-TJ
Thaith
Thai (Thailand)th-TH
Turkmen (Turkmenistan)tk-TM
Setswana (South Africa)tn-ZA
Turkishtr
Turkish (Turkey)tr-TR
Tatartt
Tatar (Russia)tt-RU
Tamazight (Latin) (Algeria)tzm-Latn-DZ
Uyghur (People's Republic of China)ug-CN
Ukrainianuk
Ukrainian (Ukraine)uk-UA
Urduur
Urdu (Islamic Republic of Pakistan)ur-PK
Uzbekuz
Uzbek (Cyrillic) (Uzbekistan)uz-Cyrl-UZ
Uzbek (Latin) (Uzbekistan)uz-Latn-UZ
Vietnamesevi
Vietnamese (Vietnam)vi-VN
Wolof (Senegal)wo-SN
isiXhosa (South Africa)xh-ZA
Yoruba (Nigeria)yo-NG
Chinese (Simplified)zh-Hans
Chinese (Traditional)zh-Hant
Chinese (People's Republic of China)zh-CN
Chinese (Hong Kong S.A.R.)zh-HK
Chinese (Macao S.A.R.)zh-MO
Chinese (Singapore)zh-SG
Chinese (Taiwan)zh-TW
isiZulu (South Africa)zu-ZA
Copied to clipboard!
Is this page helpful?