Locales

What are Locales?

It should be easy and painless for you to reach people around the world with your content, which is why Agility CMS offers unlimited Locales for free, right out of the box. Whether you want a blog post in both English and French, or a landing page in Dutch and German — we’ve got you covered.

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

To add a new Locale:

1. Navigate to the Settings section of your Agility Instance

2. Click Locales

3. Click Add Locale

4. Select a locale from the ISO locale dropdown — this list includes all standard language and region combinations (e.g. en-us, fr-ca, de-de)

5. Optionally, enter a friendly Display Name for the locale

6. Click Save Locale

💡 Need a custom locale? If none of the standard ISO locales fit your needs, you can create a custom locale by entering your own locale code and display name instead of selecting from the dropdown.

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 the action in the prompt

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. You can drag and drop locales into your preferred order directly from the Locales settings page.

To reorder locales:

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

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

[Screenshot: Locales page showing drag-and-drop reordering in action with the grab handle visible]

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