Manage locales

Set up a locale

NOTE: You need to have administrator permissions to set up locales.

NOTE: Locales are set up on an environment level.

To set up a locale:

1. Log in to the Contentful web app.

2. Сlick Settings and select Locales from the drop-down menu. The Locales page is displayed.

3. Under the Locales usage area, click + Add locale. The New locale page is displayed.

4. Under the Locale area, select the required locale from the drop-down menu. Pay attention to the language-region keys.

5. Optional: Under the Fallback locale area, select a fallback locale to be displayed whenever a field is empty in the selected locale.
   
   NOTE: For example, you can leave fields empty for EN-UK locale and set it to fall back to EN-US. You can then fill both locales with content only if there are regional differences.
    

6. Under the Locale settings area, select the checkboxes to activate the following options:

   • Enable this locale in response -  Select this checkbox to include the locale in the responses of both the Content Delivery API and the Content Preview API.

   • Enable editing for this locale - Select this checkbox to make the locale visible to editors and enable it in the Content Management API.
     
     NOTE: These settings are selected by default.

   • Allow required fields to be empty for this locale (not available for locale-based publishing) - Select this checkbox if you have required fields in your content type. If the checkbox is not selected, your editors cannot publish content without adding content to the required field.

7. Click Save. Your locale is added to your environment.

For a more in-depth guide to locales and setting them up, see our locale concept documentation.

Edit a locale

To edit an existing locale:

1. Log in to the Contentful web app.

2. Сlick Settings and select Locales from the drop-down menu. The Locales page is displayed.

3. Go to the required locale and click to open it.

4. Edit the fields or locale options you’d like, and click Save to apply the changes.

Delete a locale

To delete an existing locale:

NOTE: You cannot delete the default locale for a space.

1. Log in to the Contentful web app.

2. Сlick Settings and select Locales from the drop-down menu. The Locales page is displayed.

3. Go to the required locale and click to open it.

4. Click Delete. The delete locale dialog is displayed. Make sure you’re deleting the correct locale.

5. Enter the code for the locale to confirm, and click Delete.

6. To cancel, click the grey Don’t Delete button.