> This page is for version Generative (default).
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

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

# Multilingual support setup

Ada supports multilingual functionality so your AI Agent can communicate with 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.

## Enable languages

1. To get started, in the Ada dashboard, go to **AI Agent profile > Languages**.
2. Under **Available Languages**, select the languages you want your AI Agent to support in addition to English (which is always enabled).

**Best practice**: 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 your AI Agent’s starting language\[#set-starting-language]

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

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

### Add the language to Embed2 script\[#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 our [Embed2 documentation](../../channels/chat/widget-embedding).
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>
   ```

## Language detection in web chat\[#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 will use it.

2. **Browser language**: If no language is set in the Embed2 script, your AI Agent checks the 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.

## Language detection in other channels\[#determine-language-channels]

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