> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/business-management/multilingual/locale-management/locales/introduction.md

## Article Content:

# About the Locales API

The Multilingual Locales API allows you to manage a site's locales. By supporting multiple locales, a site can cater to different languages and regions, helping Wix users reach a global audience.

With the Locales API, you can:

- Create, update, and delete locales for a site.
- Retrieve and query locales.
- Change a site's primary locale. 
- Retrieve a list of locales supported by Wix.

To retrieve or update a site's locale settings, or enable multilingual mode, refer to the [Locale Settings API](https://dev.wix.com/docs/api-reference/business-management/multilingual/locale-management/locale-settings/introduction.md). 

## Before you begin

It's important to note the following points before starting to code:

- The Wix user must install the [Wix Multilingual app](https://www.wix.com/app-market/wix-multilingual?searchLocation=home) on their site. 
- Create, update and delete methods can only be called on sites where [multilingual mode](https://dev.wix.com/docs/api-reference/business-management/multilingual/locale-management/locale-settings/set-multilingual-mode.md) is enabled. 
- You can't change a primary locale to a secondary locale that already exists on a site. You must first delete the secondary locale and then call Create New Primary Locale. 
- A site can have up to 200 locales and up to 100 visible locales.

## Use cases

- [Implement a custom language switcher](https://dev.wix.com/docs/api-reference/business-management/multilingual/locale-management/locales/sample-flows.md#implement-a-custom-language-switcher).
- [Change the primary locale of a site](https://dev.wix.com/docs/api-reference/business-management/multilingual/locale-management/locales/sample-flows.md#change-primary-locale).

## Terminology

- **Locale**: A combination of the language and optional region code that defines how content should be displayed for a specific audience.
- **Primary locale**: The locale in which the site is created, serving as the default language and regional settings. This locale serves as the base for translating to other locales. 
- **Visitor primary locale**: The default language shown to site visitors when they first visit the site and no language is specified in the site's URL. 
- **Secondary locale**: A locale on your site that is used to display translated content or localized versions on the site based on visitor preferences. 
- **Visibility**: The status of a locale. 
    - **Visible**: Visible locales are visible to site visitors, meaning visitors can view the site in that locale. 
    - **Hidden**: Hidden locales can't be accessed by site visitors, but are available to Wix users for translating content in that locale.  


<!-- REST:
- Create a multilingual website with multiple locales.
- Update locale settings for regional customization.
- Retrieve supported locales for a specific language.
 Velo:
- Implement a language switcher for a Wix site
- Customize URL structures for different language versions
SDK:
- Integrate locale management into a third-party translation tool
- Synchronize locale settings with an external content management system -->

@sdk_package_setup