Setting Up Localization on Your ButterCMS Account

  1. Enabling Localization
  2. Localization of Pages
  3. Localization of Collections

Localization is the act of customizing your content to the specific locale (geographic location) of the person interacting with your content.

ButterCMS has full support for the localization of your content. Locale names and keys are completely customizable.

Enabling Localization

To set up Localization in your ButterCMS account, just go to Settings > Localization and enter the name and slug for all the Locales you are setting up:

undefined

By default, the first Locale you enter will be your Default Locale. You can change this anytime, by clicking on the radio button for the Locale you want to set as the default:

undefined

Localization of Pages

Once you have Localization enabled with your default language set (i.e. English shown in the image above), creating localized versions of each page can be done as follows:

Important: After entering content in your default language, the pages created in other languages will remain empty until you enter that translated content:

Localization of Collections

Localization for Collections works similarly.  All the fields in your Default Locale will be defined and the same fields are created for other Locales automatically. However, once similarly to Pages, the content you create for your default locale in a Collection will not automatically translate to your other localized Collections. The Collection for other Locales will stay empty until you have updated them with the appropriate translated content.

To complete translating all of your content to fill the other localized versions of each Page or Collection, you can approach this one of two ways.  You can utilize Butter's Write API to translate and automatically write in this translated content into your localized pages: Write API for Translating Content.

Alternatively, you can use a third-party tool or writer proficient in the additional languages to translate this content update the localized Pages and Collections with the translated content. 

Still have a question?

Our Customer Success team is standing by to help.