Localize Pages with language variants (Beta)

Beta: This feature is available via an open beta. Please help us improve this feature by sharing feedback in the Page Builder.

Help your sellers engage buyers more effectively by providing the most up-to-date content in their local language. Page localization makes this possible by establishing a single primary Page as the source of truth. From this primary Page, you can create and manage multiple language variants, eliminating the manual burden of maintaining separate Pages for each region.

See how it looks

Key features

• Create language-specific variants from a primary Page
• Use AI to translate Page text instantly
• Keep the Page structure and layout consistent across all languages
• Manage updates from the primary Page and review changes in each variant
• Easily track localized Pages in the Pages Library

You need this to succeed

The quick way

1. Click Libraries in the top menu and navigate to the All Pages library.
2. Open the Page you wish to be the primary, click the language selector, and choose Add language variant. 
3. Choose a language and optionally use AI for a one-time translation.
4. Review and edit the content within the new variant Page.
5. Save the variant.
6. Open, review, and save each variant whenever the structure or content of the primary Page changes.

Do this step by step

Create a language variant

1. Navigate to the Library tab in the Admin App.
2. If your organization uses Divisions, select the relevant one from the top left dropdown menu.

3. Locate and select a Page to localize, or follow the steps in the Create a Page article.

   Note: Global Pages can not be localized.

4. In the Page Builder, click the language selector dropdown in the upper right.
   • If a single locale has already been assigned to the Page, that language is displayed in the dropdown.
   • If no locales have been assigned or more than one locale has been assigned, Unknown language is displayed in the dropdown.
5. Select Add language variant.
6. In the pop-up menu, the steps vary depending on whether or not one or more locales have already been assigned to the Page:
   • Zero or multiple locales assigned:
     • The Assign primary language step enables you to select the Page’s main language from a list of available languages. If multiple locales have already been assigned, those languages will be displayed at the top of the list in a Current languages section. Select a language and click Continue.
     • In the Choose language variant step, select a language from the dropdown.
   • A single locale has been assigned: The assigned locale is automatically selected as the primary language, and you will only have the Choose language variant step. Select a language from the dropdown.

7. Select the Use AI to provide initial translations checkbox to prefill the variant Page with automatically translated text.

   Note: AI-powered Page translation is available on eOS Expert, eOS Advanced, and legacy Ultimate plans.

   Note: AI translations are only applied when the variant is created. Any subsequent text changes must be manually translated.

8. Click Create Variant. The builder will immediately save the primary Page and switch to the new variant.
   From here, you can manually modify the AI text translations and or replace assets with localized versions in your library.
9. Click Save.

Note: Once a variant is created, its locale is permanently locked to ensure that content is distributed correctly. If you need a Page for a different language, you must create a new variant with the desired locale.

Tip: You can easily distinguish between primary Pages and variants in the Page Library. Primary Pages have a blue background and a star in the Languages column, while variants have a gray background.

Manage updates from the primary Page

The primary Page serves as the blueprint for your localized Pages, defining the structure and layout for all linked variants. This ensures brand consistency and prevents localized content from accidentally breaking the core Page structure. 

Tip: You can view the link between the primary and variant Pages in the Localization tab of the details panel.

When you modify the structure of a primary Page (e.g., add a new block), you'll also need to publish those changes to each of its variants.

1. Navigate to the Library tab in the Admin App.
2. If your organization uses Divisions, select the relevant one from the top left dropdown menu.
3. Locate and select the primary Page you want to update.
4. Make structural changes and click Save. A notification appears to remind you that the variants also need to be updated.
5. Open the variant Page you need to update:
   • From the primary Page: While still in the Page Builder, click the language selector in the top-right corner and choose the variant.
   • From the Page Library: Navigate to the Pages library, select the Page variant, and click Edit Page.
6. A warning icon appears next to the language selector to indicate that changes from the primary Page are ready for review. Click the icon to highlight the updated blocks.

7. Review the changes to ensure they work with your localized content. Text additions are not propagated to the variant(s).

   Note: AI-powered Page translation is available on eOS Expert, eOS Advanced, and legacy Ultimate plans.

   Note: AI translations are only applied when the variant is created. Any subsequent text changes must be manually translated.

8. Click Save to apply the structural updates and make them visible to users. Repeat this step as necessary for all other variants.

Note: To avoid breaking the core structure between the primary and variant Pages, we recommend that you only modify the primary Page’s content and design settings of existing blocks, not add, remove, or reorder them.

Unlink variants

When primary and variant Pages are linked, structural changes are not possible. However, during this Beta phase, you can unlink a variant from its primary by archiving it and then unarchiving it. This removes the structural link to the Primary Page, allowing you to edit the structure independently.

1. Navigate to the Library tab in the Admin App.
2. If your organization uses Divisions, select the relevant one from the top left dropdown menu.
3. Navigate to All Pages and select the Page variant.
4. Archive the Page:
   • From the Page Library: Select the checkbox for the Page and click the Archive option in the bar.
   • From the Page’s details pane: Click the Archive icon at the top.
5. Navigate to Archived Pages and select the Page variant.
6. Restore the Page:
   • From the Page Library: Select the checkbox for the Page and click the Restore option in the bar.
   • From the Page’s details pane: Click Restore.
7. Make structural changes and click Save.

FAQs and Troubleshooting