Locales

What are Locales?

Locales let you reach people around the world in their own language. Whether you want a blog post in both English and French, or a landing page in Dutch and German, each locale gives that content a place to live.

From the Locales settings page you can add, disable, and reorder locales to control how they appear and behave throughout your instance.

Add a New Locale

⚠️ Before you begin: adding a locale is close to permanent. You can disable a locale yourself at any time, but permanently deleting one has to be done by the Agility support team. It’s worth settling on your list of locales before you start creating them.

To add a new Locale:

1. Navigate to the Settings section of your Agility Instance

2. Click Locales

3. Click Add Locale

4. Choose a region from the Locale Region dropdown. This list covers standard language and region combinations (for example en-us, fr-ca, de-de).

The dropdown is searchable, but it searches by locale code, not language name. Type es to see Spanish-speaking regions, or es-mx to jump straight to Mexico. Typing “Spanish” returns no results.

5. Enter a Locale Name. This is required, and it is the friendly name shown in locale selectors throughout the app.

6. Click Create Locale

💡 Note: Create Locale stays disabled until both Locale Region and Locale Name have values.

💡 Need a custom locale? If none of the standard regions fit, tick Custom Locale ID in the Add Locale dialog. The Locale Region dropdown is replaced by a free-text field where you can enter your own locale code alongside the Locale Name.

Edit a Locale

You can rename a locale after creating it. The locale code itself is locked once the locale exists.

1. Navigate to Settings > Locales

2. Hover over the locale you want to rename

3. Click the pencil icon

4. Update the Locale Name and save

💡 Note: only the name can be changed. If you need a different locale code, create a new locale and contact support about removing the old one.

Disable vs. Delete: Which Should You Choose?

Agility CMS offers two ways to remove a locale from use: disabling and deleting. They serve different purposes, and choosing the right one depends on why you’re removing the locale and how much content it contains.

Disable a Locale

Disabling is a self-service, instant, and reversible action. When you disable a locale, it is immediately hidden from the Agility CMS interface: it won’t appear in locale dropdowns, content lists, or page management. However, the locale and all of its content still exist in your instance and can be re-enabled at any time.

Best for:

• Accidentally created locales: for example, you entered “fr_ca” instead of “fr-ca”, or “CA-EN” instead of “en-ca”

• Locales with little or no content: since the data is still stored, a mostly-empty locale has minimal overhead

• Temporary removal: you may want to bring the locale back later

Because disabled locales still exist in the system, their content continues to count toward your entity usage. For locales with very little content, this is negligible. But if the disabled locale contains a significant amount of content, you may want to consider deletion instead.

Delete a Locale

Deleting is a permanent and irreversible action that must be performed by the Agility support team. When a locale is deleted, all content associated with it is permanently removed, and your entity count is reduced accordingly.

Best for:

• Content-rich locales you no longer need: for example, your instance has full English and French content, and you decide to stop serving English entirely. Deleting the English locale removes all of that content and frees up those entities, which can meaningfully reduce your usage.

• Cleaning up locales that can’t be reused: if a locale was created with the wrong code and has accumulated content that needs to be rebuilt in the correct locale anyway

To request a locale deletion or a locale code change, please contact us through the chat in your Instance or by emailing support@agilitycms.com.

How to Disable a Locale

To disable a locale:

1. Navigate to Settings > Locales

2. Hover over the locale you want to disable

3. Click the ✕ icon that appears

4. Confirm in the Disable Locale dialog. It explains that the locale will be removed from the content editor, and offers Contact Support if you need it permanently deleted instead.

The locale will move to the Disabled Locales section at the bottom of the page. To re-enable it, hover over it and click the pencil icon.

💡 Note: Disabling a locale does not delete any content. All content associated with a disabled locale is preserved and will be accessible again once the locale is re-enabled.

How to Delete a Locale

Deleting a locale permanently removes it and all of its associated content from your instance. This action is irreversible and must be performed by the Agility support team.

To delete a locale, you must first disable it. Once a locale is disabled, contact us through the chat in your instance or by emailing support@agilitycms.com to request permanent deletion.

Reorder Locales

The order of your locales determines how they appear in the locale switcher dropdown throughout Agility CMS, in Pages, Content, and other sections.

There are two ways to reorder them.

Drag and drop

1. Navigate to Settings > Locales

2. Click and drag the grab handle (⠿) on the left side of any locale row

3. Drop it in your desired position

Move Up / Move Down

1. Hover over the locale you want to move

2. Click the ↑ or ↓ button

💡 Note: the top row has no Move Up, and the bottom row has no Move Down.

The new order is saved automatically and will be reflected immediately across the product.

Switching Between Locales

If your instance has multiple locales set up, you can easily switch between them from the Pages and Content sections of Agility.

1. Locate and click the locale dropdown in the top left-hand corner of the page

2. Choose the Locale you’d like to switch to