> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cosmo.humanizing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Localization & Language

> Configure language settings to serve international visitors with a multilingual chat experience

## 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.

<Tip>
  The chat widget automatically adapts its interface text based on the visitor's browser language if that language is enabled. Visitors can also manually switch languages within the widget.
</Tip>

## Accessing Localization Settings

1. Navigate to your agent in the dashboard
2. Click on **Deploy** in the sidebar
3. Select **Chat Widget** to access the settings
4. Scroll to the **Localization** section

The localization settings display your current configuration including the default language and the number of enabled languages.

## Default Language

<Tip>
  You can also set the default language when first creating an agent. The creation modal and onboarding wizard both include a language selector so your agent is configured correctly from the start.
</Tip>

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

1. Click the **Manage** button in the Localization section
2. In the language selection modal, hover over your desired language
3. Click **Make Default** to set it as the primary language
4. Click **Save** to apply changes

<Note>
  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.
</Note>

## 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:

1. Browse or search for languages using the search field
2. Check the checkbox next to each language you want to enable
3. Use **Select All** to enable all filtered languages at once
4. Click **Save** to apply your changes

### Disabling Languages

1. Uncheck the checkbox next to languages you want to disable
2. Use **Deselect All** to disable all filtered languages (except the default)
3. Click **Save** to apply your changes

<Warning>
  Disabling languages removes them from the language selector in the chat widget. Visitors using a disabled language will be switched to the default language.
</Warning>

## Supported Languages

The platform supports over 40 languages covering major regions worldwide:

<AccordionGroup>
  <Accordion icon="globe-americas" title="Americas">
    | Language                | Code     |
    | ----------------------- | -------- |
    | English                 | `en`     |
    | Spanish                 | `es`     |
    | Spanish (Latin America) | `es-419` |
    | Portuguese (Brazil)     | `pt-BR`  |
    | Portuguese              | `pt`     |
  </Accordion>

  <Accordion icon="globe-europe" title="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`    |
  </Accordion>

  <Accordion icon="globe-asia" title="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`    |
  </Accordion>
</AccordionGroup>

## 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:

<Steps>
  <Step title="Browser language">
    If the visitor's browser language matches an enabled language, the widget uses it automatically.
  </Step>

  <Step title="Previous selection">
    If the visitor previously selected a language, the widget remembers their preference.
  </Step>

  <Step title="Default fallback">
    If no match is found, the widget displays in your configured default language.
  </Step>
</Steps>

## Best Practices

<AccordionGroup>
  <Accordion icon="bullseye" title="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.
  </Accordion>

  <Accordion icon="book" title="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.
  </Accordion>

  <Accordion icon="users" title="Match your audience">
    Analyze your website traffic to identify which languages your visitors use most frequently. Prioritize enabling those languages.
  </Accordion>

  <Accordion icon="message" title="Set appropriate default">
    Choose a default language that matches your primary audience. This ensures the best first impression for most visitors.
  </Accordion>

  <Accordion icon="globe" title="Test in each language">
    Use the [Playground](/agents/playground) to test conversations in each enabled language. Verify the agent responds appropriately and the experience is consistent.
  </Accordion>
</AccordionGroup>

## 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

<CardGroup cols={2}>
  <Card title="Widget Configuration" icon="sliders" href="/customization/widget">
    Configure welcome messages and suggested questions for your enabled languages.
  </Card>

  <Card title="Styling & Appearance" icon="palette" href="/customization/styling">
    Customize the visual appearance of your chat widget.
  </Card>

  <Card title="Test in Playground" icon="flask" href="/agents/playground">
    Test your agent's multilingual responses before going live.
  </Card>

  <Card title="Deploy Your Widget" icon="code" href="/agents/deployment">
    Get the embed code and add your localized widget to your website.
  </Card>
</CardGroup>