Internationalization

📘

This guide is specific to Web SDK 2.0. If you are still using 1.x, you can find documentation here. Contact your Incode Representative for upgrade information and check if you are a candidate for this upgrade.

Full rollout to all clients still TBD.


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