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.
| 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
Updated 1 day ago
