Skip to main content
Primer Checkout Web supports multiple languages and automatically adapts the checkout UI to the shopper’s locale. You can pass a locale to the SDK to display the checkout in the desired language. If a specific regional variant is not supported, Primer Checkout falls back gracefully to the closest available language.

Supported Locales

Primer Checkout Web supports the following locales:
LocaleLanguageLocaleLanguage
arArabicmsMalay
bgBulgariannbNorwegian Bokmål
caCatalannlDutch
csCzechnl-NLDutch (Netherlands)
daDanishplPolish
deGermanptPortuguese
elGreekpt-BRPortuguese (Brazil)
enEnglishroRomanian
en-GBEnglish (UK)ruRussian
en-USEnglish (US)skSlovak
esSpanishslSlovenian
es-ARSpanish (Argentina)sr-RSSerbian (Serbia)
es-MXSpanish (Mexico)svSwedish
et-EEEstonian (Estonia)thThai
fi-FIFinnish (Finland)trTurkish
frFrenchuk-UAUkrainian (Ukraine)
heHebrewviVietnamese
hrCroatianzh-CNChinese (Simplified)
huHungarianzh-HKChinese (Hong Kong)
idIndonesianzh-TWChinese (Traditional)
itItalian
jaJapanese
koKorean
ltLithuanian
lt-LTLithuanian (Lithuania)
lvLatvian
lv-LVLatvian (Latvia)
Regional variants automatically fall back to the base language. For example, pl-PL (Polish - Poland) will use pl (Polish) translations.

Locale Fallback Behavior

Primer Checkout Web uses BCP 47 language tags and implements automatic fallback for regional variants.

How it works

  1. Exact match: The SDK first looks for an exact match (e.g., pl-PL)
  2. Base language fallback: If no exact match exists, it falls back to the base language (e.g., pl)
  3. Default fallback: If neither matches, it defaults to en-GB

Usage

Check sdk options guide to learn how to pass a locale property.