Overview
Localization settings allow you to configure which languages your chat widget supports and set a default language for visitors. This enables you to create a multilingual chat experience that serves international audiences in their preferred language.Accessing Localization Settings
- Navigate to your agent in the dashboard
- Click on Deploy in the sidebar
- Select Chat Widget to access the settings
- Scroll to the Localization section
Default Language
The default language is the primary language your chat widget displays when:- A visitor’s browser language is not in your enabled languages list
- The visitor hasn’t selected a language preference
- The widget first loads for new visitors
Changing the Default Language
- Click the Manage button in the Localization section
- In the language selection modal, hover over your desired language
- Click Make Default to set it as the primary language
- Click Save to apply changes
The default language is always enabled and cannot be disabled. If you want to change the default, first make another language the default, then you can disable the previous one if needed.
Managing Enabled Languages
Control which languages are available to your visitors by enabling or disabling specific languages.Opening the Language Manager
Click the Manage button in the Localization section to open the language selection modal.Enabling Languages
In the language selection modal:- Browse or search for languages using the search field
- Check the checkbox next to each language you want to enable
- Use Select All to enable all filtered languages at once
- Click Save to apply your changes
Disabling Languages
- Uncheck the checkbox next to languages you want to disable
- Use Deselect All to disable all filtered languages (except the default)
- Click Save to apply your changes
Supported Languages
The platform supports over 40 languages covering major regions worldwide:Americas
Americas
| Language | Code |
|---|---|
| English | en |
| Spanish | es |
| Spanish (Latin America) | es-419 |
| Portuguese (Brazil) | pt-BR |
| Portuguese | pt |
Europe
Europe
| Language | Code |
|---|---|
| German | de |
| French | fr |
| Italian | it |
| Dutch | nl |
| Polish | pl |
| Romanian | ro |
| Czech | cs |
| Hungarian | hu |
| Slovak | sk |
| Slovenian | sl |
| Croatian | hr |
| Serbian | sr |
| Bosnian | bs |
| Bulgarian | bg |
| Greek | el |
| Albanian | sq-AL |
| Ukrainian | uk |
| Russian | ru |
| Swedish | sv |
| Norwegian | no |
| Danish | da |
| Finnish | fi |
| Estonian | et |
| Latvian | lv |
| Lithuanian | lt |
Asia & Middle East
Asia & Middle East
| Language | Code |
|---|---|
| Chinese (Simplified) | zh-CN |
| Chinese (Traditional) | zh-TW |
| Japanese | ja |
| Korean | ko |
| Hindi | hi |
| Tamil (India) | ta-IN |
| Thai | th |
| Vietnamese | vi |
| Indonesian | id |
| Malay | ms |
| Arabic (UAE) | ar-AE |
| Arabic (Saudi Arabia) | ar-SA |
| Hebrew | he |
| Persian | fa |
| Turkish | tr |
How Language Affects the Widget
When a visitor uses the chat widget, language settings affect several elements:| Element | Behavior |
|---|---|
| Interface text | Buttons, placeholders, and system messages display in the selected language |
| Welcome message | Shown in the configured default language (customize per language in Content settings) |
| AI responses | The agent responds in the same language the visitor uses |
| Language selector | Only enabled languages appear in the dropdown |
Visitor Language Detection
The widget uses this priority to determine the initial language:Browser language
If the visitor’s browser language matches an enabled language, the widget uses it automatically.
Previous selection
If the visitor previously selected a language, the widget remembers their preference.
Best Practices
Enable relevant languages only
Enable relevant languages only
Only enable languages for regions you actively serve. Having too many options can overwhelm visitors and may not provide a good experience if your knowledge base doesn’t cover those languages well.
Ensure knowledge base coverage
Ensure knowledge base coverage
Before enabling a language, ensure your knowledge sources have content in that language or that your agent can effectively translate and respond in that language.
Match your audience
Match your audience
Analyze your website traffic to identify which languages your visitors use most frequently. Prioritize enabling those languages.
Set appropriate default
Set appropriate default
Choose a default language that matches your primary audience. This ensures the best first impression for most visitors.
Test in each language
Test in each language
Use the Playground to test conversations in each enabled language. Verify the agent responds appropriately and the experience is consistent.
Configuration Reference
Default Values
| Setting | Default Value |
|---|---|
| Default Language | English (en) |
| Enabled Languages | All languages enabled |
Localization Settings Summary
| Setting | Description |
|---|---|
| Default Language | The primary language shown when no matching visitor language is found |
| Enabled Languages | Languages available for selection in the chat widget |
Next Steps
Widget Configuration
Configure welcome messages and suggested questions for your enabled languages.
Styling & Appearance
Customize the visual appearance of your chat widget.
Test in Playground
Test your agent’s multilingual responses before going live.
Deploy Your Widget
Get the embed code and add your localized widget to your website.