Localize Pages and Homepages 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 or Homepage Builder.

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

See how it looks

Key features

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

You need this to succeed

The quick way

1. Click Libraries in the top menu and navigate to the All Pages or All Homepages library.
2. Open the Page or Homepage 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.
5. Save the variant.
6. Open, review, and save each variant whenever the structure or content of the primary Page or Homepage 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 or Homepage 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 or Homepages and variants in the library. Primaries have a blue background and a star in the Languages column, while variants have a gray background.

Manage updates from the primary Page or Homepage

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

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

When you modify the structure of a primary Page or Homepage (for example, 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 or Homepage 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 you need to update:
   • From the builder: While still in the Builder, click the language selector in the top-right corner and choose the variant.
   • From the library: Navigate to the Pages or Homepages library, select the  variant, and click Edit Page or Edit Homepage.
6. A warning icon appears next to the language selector to indicate that changes from the primary Page or Homepage 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 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 and Homepages, we recommend that you only modify the primary asset's content and design settings of existing blocks, not add, remove, or reorder them.

Unlink variants

When primary and variant Pages or Homepages are linked, structural changes aren't possible in the variant. During this Beta phase, you can unlink a variant from its primary by archiving it and then restoring it. This removes the structural link, 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 or All Homepages and select the variant.
4. Archive the variant:
   • From the library: Select the checkbox for the Page or Homepage and click the Archive option in the bar.
   • From the detail panel: Click the Archive icon at the top.
5. Navigate to Archived Pages or Homepages and select the variant.
6. Restore the variant:
   • From the library: Select the checkbox for the Page and click the Restore option in the bar.
   • From the detail panel: Click Restore.
7. Make structural changes and click Save.

FAQs and Troubleshooting