> To build or manage a Wix site with an AI agent, follow https://www.wix.com/headless/skill.md
> It builds a new Wix site or puts your own site online, from a prompt, and keeps changing it afterwards. The pages are code in any web technology, and Wix runs the backend.
> It works through the Wix plugin (the Wix MCP and the Wix skills), the Wix CLI or no Wix login, and puts the site live on Wix hosting or on another host.
> Business features include a store, bookings, events and tickets, a restaurant, a blog, forms, members and many more.
> Read the Wix skills online at https://www.wix.com/skills
> 
> 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`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# createLocale

# Package: @wix/multilingual

# Namespace: locales

# Method link: https://dev.wix.com/docs/api-reference/business-management/multilingual/locale-management/locales/create-locale.md

## Permission Scopes:
Wix Multilingual: SCOPE.MULTILINGUAL.MANAGE_TRANSLATIONS

## Introduction

Creates a new secondary locale.

This method adds a new secondary locale to the site. A site can have up to 200 locales and up to 100 visible locales.

To retrieve a list of all locales supported by Wix that can be created on a site, call List Supported Locales.

<blockquote class="important">
<strong>Important:</strong>

- This method can only be called on sites where multilingual mode is enabled. To enable multilingual mode, call [Set Multilingual Mode](https://dev.wix.com/docs/api-reference/business-management/multilingual/locale-management/locale-settings/set-multilingual-mode.md).
- This method creates only secondary locales. To create and set a new primary locale, call Create New Primary Locale.

</blockquote>

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.multilingual.locales.createLocale(locale)
 Description: Creates a new secondary locale.  This method adds a new secondary locale to the site. A site can have up to 200 locales and up to 100 visible locales.  To retrieve a list of all locales supported by Wix that can be created on a site, call List Supported Locales.  <blockquote class="important"> <strong>Important:</strong>  - This method can only be called on sites where multilingual mode is enabled. To enable multilingual mode, call [Set Multilingual Mode](https://dev.wix.com/docs/api-reference/business-management/multilingual/locale-management/locale-settings/set-multilingual-mode.md). - This method creates only secondary locales. To create and set a new primary locale, call Create New Primary Locale.  </blockquote>
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  locale, locale.languageCode
 Method parameters: 
   param name: locale | type: Locale   | required: true 
        - name: languageCode | type: string | description: Language code. For example, `"en"` for English. | required: true | validation: format LANGUAGE, immutable
        - name: regionCode | type: string | description: Region code. For example, `"UK"` for United Kingdom.  | validation: format COUNTRY, immutable
        - name: visibility | type: LocaleVisibility | description: Locale visibility status.  
             - enum:
             -     HIDDEN: Locale is hidden from site visitors. A site's locale should be hidden when a translation is not ready to be exposed to visitors.
             -     VISIBLE: Locale is visible to site visitors. A site can only have up to 100 visible locales.
        - name: flag | type: string | description: Flag icon as a 3-letter language code based on Wix's supported locales. For example, `"USA"` for the United States flag icon.  | validation: maxLength 3
        - name: regionalFormat | type: string | description: Regional format for determining how to display data types such as dates, times, numbers, and currencies. For example, `"en-US"` to format dates like this: `MM-DD-YYYY`.  | validation: format LANGUAGE_TAG
        - name: urlStructureOverride | type: UrlStructureOverride | description: Optional override for the locale's default URL structure.  
           - name: urlStructure | type: UrlStructure | description: URL structure to use instead of the default.  
                 - enum:
                 -     SUBDIRECTORY: URL structure as a subdirectory. For example, `"www.mysite.com/fr"`.
                 -     SUBDOMAIN: URL structure as a subdomain. For example, `"fr.mysite.com"`.
                 -     QUERY_PARAM: URL structure as a query parameter. For example, `"www.mysite.com?lang=fr"`.
        - name: machineTranslationCode | type: string | description: Language code based on Wix's supported locales, used to specify the target language when translatable content is sent for machine translation. For example, `"ES"` for Spanish or `"ZH_TW"` for Traditional Chinese.  Default: The locale's `languageCode` value.  | validation: format LANGUAGE_TAG
        - name: overrideDisplayName | type: string | description: Optional override for the locale's display name.  | validation: maxLength 30
 Return type: PROMISE<Locale>
  - name: _id | type: string | description: Locale GUID.  The locale GUID is made up of the language and region codes supported by Wix. For example, `"en-US"` for U.S. English.  | read-only: true | validation: maxLength 20, format LANGUAGE_TAG, immutable
  - name: revision | type: string | description: Revision number, which increments by 1 each time the locale is updated. To prevent conflicting changes, the existing revision must be passed when updating the locale object.  | read-only: true | validation: format int64
  - name: _createdDate | type: Date | description: Date and time the locale was created.  | read-only: true 
  - name: _updatedDate | type: Date | description: Date and time the locale was last updated.  | read-only: true 
  - name: languageCode | type: string | description: Language code. For example, `"en"` for English.  | validation: format LANGUAGE, immutable
  - name: regionCode | type: string | description: Region code. For example, `"UK"` for United Kingdom.  | validation: format COUNTRY, immutable
  - name: visibility | type: LocaleVisibility | description: Locale visibility status.  
     - enum:
     -     HIDDEN: Locale is hidden from site visitors. A site's locale should be hidden when a translation is not ready to be exposed to visitors.
     -     VISIBLE: Locale is visible to site visitors. A site can only have up to 100 visible locales.
  - name: primaryLocale | type: boolean | description: Whether the locale is the site's primary locale.  | read-only: true 
  - name: visitorPrimaryLocale | type: boolean | description: Whether the locale is the site's visitor primary locale.  | read-only: true 
  - name: flag | type: string | description: Flag icon as a 3-letter language code based on Wix's supported locales. For example, `"USA"` for the United States flag icon.  | validation: maxLength 3
  - name: regionalFormat | type: string | description: Regional format for determining how to display data types such as dates, times, numbers, and currencies. For example, `"en-US"` to format dates like this: `MM-DD-YYYY`.  | validation: format LANGUAGE_TAG
  - name: effectiveUrlStructure | type: UrlStructure | description: Default URL structure for the locale's live site URL, based on the locale's settings, unless overridden.  | read-only: true 
     - enum:
     -     SUBDIRECTORY: URL structure as a subdirectory. For example, `"www.mysite.com/fr"`.
     -     SUBDOMAIN: URL structure as a subdomain. For example, `"fr.mysite.com"`.
     -     QUERY_PARAM: URL structure as a query parameter. For example, `"www.mysite.com?lang=fr"`.
  - name: urlStructureOverride | type: UrlStructureOverride | description: Optional override for the locale's default URL structure.  
     - name: urlStructure | type: UrlStructure | description: URL structure to use instead of the default.  
  - name: machineTranslationCode | type: string | description: Language code based on Wix's supported locales, used to specify the target language when translatable content is sent for machine translation. For example, `"ES"` for Spanish or `"ZH_TW"` for Traditional Chinese.  Default: The locale's `languageCode` value.  | validation: format LANGUAGE_TAG
  - name: effectiveDisplayName | type: string | description: The locale's `displayName`, unless overridden.  | read-only: true | validation: maxLength 30
  - name: displayName | type: string | description: Default display name for the locale, inferred from the locale GUID and region code.  | read-only: true | validation: maxLength 30
  - name: overrideDisplayName | type: string | description: Optional override for the locale's display name.  | validation: maxLength 30


```

### Examples

### createLocale
```javascript
import { locales } from '@wix/multilingual';

async function createLocale(locale) {
  const response = await locales.createLocale(locale);
};
```

### createLocale (with elevated permissions)
```javascript
import { locales } from '@wix/multilingual';
import { auth } from '@wix/essentials';

async function myCreateLocaleMethod(locale) {
  const elevatedCreateLocale = auth.elevate(locales.createLocale);
  const response = await elevatedCreateLocale(locale);
}
```

### createLocale (self-managed)
Self-managed SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { locales } from '@wix/multilingual';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { locales },
  // Include the auth strategy and host as relevant
});


async function createLocale(locale) {
  const response = await myWixClient.locales.createLocale(locale);
};
```

---