Skip to main content

Configuring Internationalization locales

🏗 Work in progress

The content of this page might not be fully up-to-date with Strapi 5 yet.

The Internationalization plugin allows to manage content in different languages, called "locales". Once the Internationalization plugin is installed in a Strapi application (see Installing plugins via the Marketplace), administrators can manage locales from Settings icon Settings > Global settings > Internationalization.

i18n settingsi18n settings

The Internationalization settings sub-section displays a table listing all locales available for the Strapi application. By default, only the English locale is configured and set as the default locale.

For each locale, the table displays the default ISO code of the locale, its optional display name and indicates if the locale is set as the default one. From the table, administrators can also:

  • Click on the edit button Edit icon to edit a locale
  • Click on the delete button Delete icon to delete a locale

Adding a new locale​

Administrators can add and manage as many locales as they want. There can however only be one locale set as the default one for the whole Strapi application.

✏️ Note

It is not possible to create custom locales. Locales can only be created based on the 500+ pre-created list of locales set by Strapi.

To add a new locale:

  1. Click on the Add new locale button.
  2. In the locale addition window, choose your new locale among the Locales drop-down list. The latter lists alphabetically all locales, displayed as their ISO code, that can be added to your Strapi application.
  3. (optional) In the Locale display name textbox, write a new display name for your new locale.
  4. (optional) In the Advanced settings tab, tick the Set as default locale setting to make your new locale the default one for your Strapi application.
  5. Click on the Save button to confirm the addition of your new locale.