> ## Documentation Index > Fetch the complete documentation index at: https://docs.ansa.so/llms.txt > Use this file to discover all available pages before exploring further. # Multi-Language Support > Configure your AI assistant to communicate with visitors in their preferred language Ansa supports **26+ languages** out of the box, allowing your AI assistant to communicate with visitors in their preferred language. The widget automatically detects the visitor's language and displays appropriate messages. ## Supported Languages | Language | Code | Language | Code | | ---------- | ---- | ---------- | ---- | | English | `en` | Japanese | `ja` | | Spanish | `es` | Korean | `ko` | | French | `fr` | Chinese | `zh` | | German | `de` | Arabic | `ar` | | Italian | `it` | Hindi | `hi` | | Portuguese | `pt` | Turkish | `tr` | | Dutch | `nl` | Vietnamese | `vi` | | Polish | `pl` | Thai | `th` | | Russian | `ru` | Indonesian | `id` | | Swedish | `sv` | Malay | `ms` | | Danish | `da` | Czech | `cs` | | Norwegian | `no` | Ukrainian | `uk` | | Finnish | `fi` | Hebrew | `he` | *** ## How Language Detection Works The widget uses a **priority-based detection system** to determine which language to display: ### Detection Priority Explicitly set the language on your embed script: ```html theme={null} ``` The widget reads your page's declared language: ```html theme={null} ``` Falls back to the visitor's browser language preference (`navigator.language`), e.g., `en-US`, `fr-CA`. ### Cascade Fallback When a language is detected, Ansa uses **smart fallback** to find the best matching translation: 1. **Exact match** — `fr-CA` (Canadian French) 2. **Base language** — `fr` (French) 3. **Default language** — Your configured default (e.g., `en`) This ensures visitors always see appropriate content, even if you haven't created a specific regional translation. *** ## Adding Translations You can customize all visitor-facing messages for each language. ### Step 1: Navigate to Translations 1. Go to your agent's **Embed** page 2. Scroll down to the **Translations** section ### Step 2: Add a New Language 1. Click the **language dropdown** and select a language 2. Click **"Add Translation"** ### Step 3: Customize Messages For each language, you can customize: | Field | Description | | ----------------------- | -------------------------------------------------------- | | **Display Name** | The assistant's name shown in the chat header | | **Initial Message** | The greeting message when the chat opens | | **Suggested Messages** | Quick-reply buttons shown to visitors (one per line) | | **Message Placeholder** | Placeholder text in the input field | | **Dismissible Message** | Text shown before the chat is opened | | **Welcome Bubbles** | Preview messages shown on the chat bubble (one per line) | ### Step 4: Set Default Language Choose which language to use when no translation matches the visitor's language. *** ## Dynamic Language Switching For websites with language switchers, you can change the widget language at runtime using JavaScript: ### Set Language ```javascript theme={null} // Switch to French window.ansa.setLanguage('fr'); // Switch to Spanish window.ansa.setLanguage('es'); ``` ### Get Current Language ```javascript theme={null} const currentLang = window.ansa.getLanguage(); console.log(currentLang); // "fr" ``` ### Example: Sync with Website Language Switcher ```javascript theme={null} // When user changes language on your website document.getElementById('language-select').addEventListener('change', (e) => { const newLang = e.target.value; // Update Ansa widget language if (window.ansa) { window.ansa.setLanguage(newLang); } }); ``` *** ## Automatic Detection During Onboarding When you create a new agent via onboarding, Ansa automatically: 1. **Detects your website's primary language** from the `` attribute 2. **Sets default messages** in that language 3. **Discovers alternate languages** from `` tags 4. **Creates translation records** for each discovered language This means multilingual websites get pre-configured translations out of the box! *** ## Best Practices Choose a default language that most of your visitors understand. This is used when no translation matches. If you serve specific regions, create translations for regional variants: * `es` — Spanish (general) * `es-MX` — Mexican Spanish * `es-AR` — Argentinian Spanish Translations may be longer in some languages. Keep your messages concise to ensure they display well across all languages. Preview your widget in each language to ensure messages display correctly and feel natural. If your website has a language switcher, use the `data-lang` attribute or `window.ansa.setLanguage()` to ensure the widget matches the page language: ```html theme={null} ``` *** ## API Reference ### Get Translations ```bash theme={null} GET /api/interface-settings/{agentId}/translations ``` Returns all translations for an agent. ### Get Single Translation ```bash theme={null} GET /api/interface-settings/{agentId}/translations/{languageCode} ``` ### Create/Update Translation ```bash theme={null} PUT /api/interface-settings/{agentId}/translations/{languageCode} { "displayName": "Assistant", "initialMessage": "Hello! How can I help?", "suggestedMessages": ["Pricing", "Contact"], "messagePlaceholder": "Type a message...", "dismissibleMessage": "Chat with us", "welcomeBubbles": ["Welcome!", "Ask me anything"] } ``` ### Delete Translation ```bash theme={null} DELETE /api/interface-settings/{agentId}/translations/{languageCode} ``` ### Update Default Language ```bash theme={null} PUT /api/interface-settings/{agentId}/default-language { "defaultLanguage": "en" } ```