> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Multilingual support setup

## Overview

Configure your AI Agent to communicate with end users in multiple languages. You can choose which languages to support, set a starting language for web chats, and configure how the AI Agent detects and switches between languages.

For information about supported languages and how multilingual works, see [About multilingual support](/docs/setup/languages/about-multilingual-support).

## Quick start

Enable multilingual support in a few steps.

On the Ada dashboard, go to **Config > AI AGENT > Settings**, then open the **Languages** tab.

Under **Available Languages**, select the languages you want your AI Agent to support.

Optionally, [set a starting language](#set-starting-language) for web chats using the Embed2 script.

For detailed instructions, see [Implementation & usage](#enable-languages).

## Implementation & usage

Configure languages and detection settings for your AI Agent.

### Enable languages\[#enable-languages]

Select which languages your AI Agent supports in addition to English (which is always enabled).

**To enable languages:**

1. On the Ada dashboard, go to **Config > AI AGENT > Settings**, then open the **Languages** tab.
2. Under **Available Languages**, select the languages you want your AI Agent to support.

> **Note**
>
> Only enable languages your team can support. Make sure someone on your team can review conversations in each language to help evaluate performance and maintain quality.

### Set starting language\[#set-starting-language]

For Messaging, use the initial [`language` setting](/messaging/web/sdk-api-reference#language) or [`setLanguage`](/messaging/web/sdk-api-reference#setlanguage). The [Automation and Languages guide](/docs/channels/messaging/automation-and-languages) connects SDK configuration to dashboard settings.

The starting language is the default language your AI Agent uses to begin web chats. If most of your end users speak a language other than English, you can set that language as the default.

By default, all AI Agents start in English, but end users can switch languages at any time.

#### Embed2 script configuration\[#embed2-language-script]

You can change the AI Agent's starting language by making a small addition to
the Ada Embed2 script. You might already be familiar with it, but if you
need a refresher, check out the [Embed2 documentation](/docs/channels/chat/chat-configuration/installation).
Let's take a look at how to set up an AI Agent's starting language to French.

1. Find the default embed script on your webpage. It should look like
   this:

   ```
   <!-- <head> -->
   <script
     id="__ada"
     data-handle="yourbothandle"
     src="https://static.ada.support/embed2.js">
   </script>
   ```

2. To set the AI Agent language, add the following `window.adaSettings`
   snippet between the head and the script of the basic Ada Embed2
   script, and add the language format code from the [ISO 639-1 language format](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes).

   ```
   <script>
     window.adaSettings = {
       language: "fr",
     }
   </script>
   ```

   Your revised Ada Embed2 script should look similar to this:

   ```
   <!-- <head> -->
   <script>
     window.adaSettings = {
       language: "fr",
     }
   </script>
   <script
     id="__ada"
     data-handle="yourbothandle"
     src="https://static.ada.support/embed2.js">
   </script>
   ```

### Web chat detection\[#determine-language-web-chat]

Your AI Agent follows this order when deciding what language to start a chat in:

1. **Embed2**: If the [Embed2 script](#embed2-language-script) specifies a default language, your AI Agent uses it.

2. **Browser language**: If no language is set in the Embed2 script, your AI Agent checks the end user's browser language.

3. **Fallback to English**: If neither is available, your AI Agent defaults to English.

> **Note**
>
> Your AI Agent can only use the languages that are enabled on the **Languages** page in the Ada dashboard.

### Other channel detection\[#determine-language-channels]

When default language settings are not available, your AI Agent uses Ada's built-in language detection to identify the end user's language based on their input.

## Related features

* [About multilingual support](/docs/setup/languages/about-multilingual-support): Learn about supported languages and how multilingual works.
* [Language switching](/docs/setup/languages/language-switching): Understand how end users can switch languages during a conversation.
* [Manual translations](/docs/setup/languages/manual-translations): Customize translations in Greetings and Handoffs.

---

Have any questions? Contact your Ada team, or email us at [](mailto:help@ada.cx?subject=Help%20Docs%20inquiry).