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

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.omni.co/feedback

```json
{
  "path": "/administration/localization",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Localization settings

> Configure language settings at the organization and user levels.

Localization settings control the language used for the Omni app interface. You can configure a default locale for your entire organization and, optionally, override it for individual users.

## Requirements

To use localization, you'll need:

* **Organization Admin permissions**, which are required to access and modify organization settings
* **To have localization enabled for your Omni instance**. Reach out to Omni support to have this feature enabled.

## Organization-level localization

Organization-level localization is managed in **Settings > General**.

### Locale

The **Locale** setting defines the default language used for the Omni app interface across your organization.

* Changes to the locale update the language of the app UI for users who don't have a user-specific locale set.
* This setting is applied at the organization level and affects all users by default.

Omni currently supports the following locales:

| Locale code | Language              |
| ----------- | --------------------- |
| `en-US`     | English (default)     |
| `de-DE`     | Deutsch (Deutschland) |
| `es-CL`     | Español (Chile)       |
| `es-ES`     | Español (España)      |
| `fr-FR`     | Français (France)     |
| `he-IL`     | עברית (ישראל)         |
| `it-IT`     | Italiano (Italia)     |
| `ja-JP`     | 日本語 (日本)              |
| `nb-NO`     | Norsk bokmål (Norge)  |
| `pt-BR`     | Português (Brasil)    |
| `pt-PT`     | Português (Portugal)  |
| `sv-SE`     | Svenska (Sverige)     |
| `vi-VN`     | Tiếng Việt (Việt Nam) |

### Allowed locales

The **Allowed locales** setting defines which locales are available for use in your Omni instance.

* Only locales in this list will be available when selecting a locale for users.
* Use this setting to limit the languages that appear as options for your organization (for example, if you only support a subset of languages internally).

## User-level localization

You can override the organization-level locale for specific users in **Settings > Users**.

To set a user-specific locale:

1. Navigate to **Settings > Users**.
2. Find the user you want to update and click **Manage**.
3. On the user's settings page, choose a value in the **Locale** field.
4. Save your changes.

Users can also set their own locale in their [user profiles](/administration/users/your-account) by clicking **their avatar > Manage account**.

When a user has a locale set on their profile:

* The user-level **Locale** controls the language of the app interface for that user.
* If no user-level locale is set, the user inherits the organization-level **Locale**.

This lets you support users who need to work in different languages within the same Omni organization.

## Embedded users

For embedded Omni experiences, you can pass a `locale` user attribute in the embed configuration to control the interface language for embed users.

When provided, this attribute behaves like a user-level locale:

* If the `locale` attribute matches one of your **Allowed locales**, it will be used for that embedded user.
* If the attribute is missing or does not match an allowed locale, the user falls back to the organization-level **Locale**.