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.
| Code | Language |
|---|---|
en | English (default) |
es | Spanish |
es-MX | Spanish (Mexico) |
es-419 | Spanish (Latin America) |
pt | Portuguese |
pt-BR | Portuguese (Brazil) |
fr | French |
fr-CA | French (Canada) |
de | German |
it | Italian |
nl | Dutch |
pl | Polish |
ru | Russian |
tr | Turkish |
ar | Arabic |
ar-EG | Arabic (Egypt) |
ar-AE | Arabic (UAE) |
zh | Chinese (Simplified) |
zh-TW | Chinese (Traditional) |
ja | Japanese |
ko | Korean |
vi | Vietnamese |
id | Indonesian |
th | Thai |
hi | Hindi |
bn | Bengali |
uk | Ukrainian |
he | Hebrew |
el | Greek |
sr | Serbian |
hr | Croatian |
hu | Hungarian |
ro | Romanian |
cs | Czech |
sk | Slovak |
ca | Catalan |
ms | Malay |
tl | Filipino/Tagalog |
sw | Swahili |
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
langproperty 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
- Theming & Styling: Customize appearance
- IncodeFlow Component: Full props reference
