Language Configuration

OmniBots includes built-in support for 24 languages, allowing your bots to communicate with users in their preferred language. The Language Configuration settings let you control which languages are available in your workspace, set a default language, and manage translation behavior.

Supported Languages

OmniBots ships with the following 24 built-in languages:

Language	Code	Direction	Language	Code	Direction
Arabic	ar	RTL	Japanese	ja	LTR
Chinese (Simplified)	zh-CN	LTR	Korean	ko	LTR
Chinese (Traditional)	zh-TW	LTR	Malay	ms	LTR
Czech	cs	LTR	Norwegian	no	LTR
Danish	da	LTR	Persian (Farsi)	fa	RTL
Dutch	nl	LTR	Polish	pl	LTR
English	en	LTR	Portuguese	pt	LTR
Farsi	fa	RTL	Russian	ru	LTR
Finnish	fi	LTR	Spanish	es	LTR
French	fr	LTR	Swedish	sv	LTR
German	de	LTR	Turkish	tr	LTR
Hebrew	he	RTL	Urdu	ur	RTL

Enabling and Disabling Languages

Not all workspaces need all 24 languages. You can enable only the languages relevant to your audience.

1. Go to Settings > Languages.
2. Toggle the switch next to each language to enable or disable it.
3. Click Save.

Disabled languages will not appear as options in bot configuration, widget language selectors, or translation workflows.

imageLanguage configuration page showing toggle switches for each of the 24 supported languages, with RTL indicator badges next to Arabic, Hebrew, Farsi, and Urdu

Language configuration with RTL indicators

TIP

Enable only the languages you actively support. Each enabled language adds to your translation workload and may increase LLM costs if you use real-time translation.

Setting the Default Language

The default language is used when OmniBots cannot determine a user's preferred language.

1. Go to Settings > Languages.
2. Select a language from the Default Language dropdown.
3. Click Save.

The default language must be one of your enabled languages. All system messages, fallback responses, and widget UI text use this language unless overridden.

RTL Support

OmniBots fully supports right-to-left (RTL) text rendering for four languages:

• Arabic (ar)
• Hebrew (he)
• Persian / Farsi (fa)
• Urdu (ur)

When a conversation is in an RTL language, the chat widget automatically adjusts:

• Text alignment switches to right-to-left
• Message bubbles mirror their layout
• Input field direction changes to RTL
• Scrollbar position moves to the left side

WARNING

RTL support applies to the chat widget automatically. If you embed bot responses in your own application, you are responsible for handling text direction in your UI.

Translation Cache

OmniBots caches translations to reduce cost and improve response times. When a message is translated, the result is stored using a SHA-256 hash of the source text for deduplication.

Setting	Description	Default
Cache Enabled	Whether to cache translated messages	On
Cache TTL	How long cached translations are retained before expiring	30 days

Cached translations are served instantly without calling the LLM. When the cache TTL expires, the next request for that translation generates a fresh translation and updates the cache.

To manage the cache, go to Settings > Languages > Translation Cache. You can clear the entire cache if you need translations to be regenerated (for example, after updating your bot's tone or terminology).

Widget Language Auto-Detection

The chat widget can automatically detect the user's preferred language using several methods, applied in order of priority:

1. Explicit parameter -- If you pass a language parameter when embedding the widget, that language is used.
2. Browser language -- The widget reads the browser's navigator.language setting.
3. URL parameter -- The widget checks for a lang query parameter in the page URL.
4. Default language -- If none of the above produce a match among your enabled languages, the workspace default is used.

TIP

For the most reliable experience, pass the language explicitly when embedding the widget. This ensures users always see the correct language regardless of browser settings.

Per-Bot Language Override

Individual bots can override the workspace language settings. In the bot configuration:

1. Open the bot in the Bot Builder.
2. Go to Settings > Language.
3. Select which enabled languages this bot supports.
4. Choose the bot's default language.

This allows you to have bots that serve only specific languages even if your workspace has many languages enabled.

Next Steps

• Configure workspace settings for timezone and branding
• Learn how to build multilingual flows using language-aware nodes