Localize pages

Prismic supports creating localized versions of your content for different languages and regions. Each locale represents a specific language and region combination, such as English - European Union.

Content writers can copy pages between locales or write individual pages for each.

You can use locales for:

• Translating content (e.g. English and Spanish content)
• Localizing content (e.g. British vs American English)
• Both translating and localizing (e.g. English and French Canadian audiences)

For example, you could have the following localized “About Us” pages:

Both pages are connected in the Page Builder for easier navigation and for developers in the API.

Localized versions of a page use the same fields and have the same available slices; just their content is different.

Select a locale

After adding locales to your repository, you can navigate between them from two places: within a page and from the page list.

From within a page

When you open any page from the page list, you will find a locale dropdown at the top to switch to another locale. This process will take you directly to the selected localized version of this particular page.

From the page list

All the locales of your repository will be available in the locale dropdown at the top left of your page list. This view allows you to navigate between different locales and see the translated pages.

Copy pages to another locale

You can copy pages to another locale individually in the Page Builder or bulk in the page list. When you copy a page individually in the Page Builder, it will open a window to define what you want to copy and which locale.

Copy all content

This option will copy all the content of your page from the source locale to the target locale. You can then translate your content manually.

Translate with AI

Translate with AI creates a translated copy of your page while keeping formatting, structure, and internal links intact. You can add instructions to keep branded terms unchanged, set the tone, or specify preferred wording.

To translate a page with AI:

• Open a page.
• Click Copy to another locale in the right sidebar.
• Choose Translate with AI.

Add a locale

• Open your locale settings

  Navigate to your Prismic repository and go to Settings > Translations & Locales.

  

• Add a locale

  In the Add new locales to this repository section, select a locale from the dropdown.

  

  If your locale is not in the list, add a custom locale by selecting Add custom locale in the dropdown.

  Click Add locale after selecting a locale.

Set the master locale

The master locale is the default locale selected when visiting the Page Builder. It is also the default locale developers receive when using Prismic’s API.

• Open your locale settings

  Navigate to your Prismic repository and go to Settings > Translations & Locales.

  

• Select a master locale

  In the Manage your locales section, click the Set as master button for your new master locale.

  

  Your selected locale will be the new default locale in the Page Builder and the Content API.

Remove a locale

• Delete all pages in the locale

  All page in a locale must be deleted before deleting the locale.

• Open your locale settings

  Navigate to your Prismic repository and go to Settings > Translations & Locales.

  

• Delete a locale

  In the Manage your locales section, click the trash can button for the locale to be deleted.