Internationalization

The SDK supports 80+ languages for UI text and error messages.

📘

This guide is specific to Web SDK 2.0. If you are still using 1.x, you can find documentation here. We strongly recommend upgrading - contact your Incode Representative for upgrade information.

The SDK supports 80+ languages for UI text and error messages.

Setting the Language

Pass the lang property inside the config object when configuring <incode-flow>:

flow.config = {
  token: session.token,
  lang: 'es', // Spanish
};

Supported Languages

The following language codes are supported. The SDK loads translations from CDN at runtime.

CodeLanguage
enEnglish (default)
esSpanish
es-MXSpanish (Mexico)
es-419Spanish (Latin America)
ptPortuguese
pt-BRPortuguese (Brazil)
frFrench
fr-CAFrench (Canada)
deGerman
itItalian
nlDutch
plPolish
ruRussian
trTurkish
arArabic
ar-EGArabic (Egypt)
ar-AEArabic (UAE)
zhChinese (Simplified)
zh-TWChinese (Traditional)
jaJapanese
koKorean
viVietnamese
idIndonesian
thThai
hiHindi
bnBengali
ukUkrainian
heHebrew
elGreek
srSerbian
hrCroatian
huHungarian
roRomanian
csCzech
skSlovak
caCatalan
msMalay
tlFilipino/Tagalog
swSwahili

Additional codes like af-ZA, am, az, bs, ceb, da-DK, et, fa-IR, fi-FI, hmn, ht, jv, ka, kk, km, ky, lo, lt, lv, mk, mn, my, nb-NO, ne, so, sv-SE, ur, uz and more are also supported.

How It Works

  • The lang property sets the UI language for all SDK components within the flow
  • Translations are loaded from Incode's CDN at runtime
  • Error messages and instructions are automatically translated
  • The language is also sent to the backend for server-side localization

Browser Language Detection

To use the browser's preferred language:

const browserLang = navigator.language.split('-')[0]; // 'en', 'es', etc.

flow.config = {
  token: session.token,
  lang: browserLang,
};

RTL Support

Right-to-left languages (Arabic, Hebrew, Farsi) are supported. The SDK automatically adjusts layout direction based on the language.

See Also