Prerequisites

Before you begin, confirm the following are in place:

• A source language page has been created and saved in Page Studio.
• Languages for your site have been configured by your agency or DX team.
• You have the appropriate permissions to publish and manage pages on the site.

ℹ️  Note

Translation can only be initiated from a source language page. If the source page does not exist yet, create and save it before proceeding.

Opening a Source Page and the Language Selector

Begin by navigating to the source language page you want to translate.

• Open Page Studio and locate the source language page from your page list.
• Open the page. In the top-left area of the editor, you will see the Language Selector.
• The selector will display the source language as the currently active selection.

• Click the Language Selector to expand it. You will see:
  • The source language currently in use.
  • Any existing translated language pages already created for this source.
  • An Add Language option to create a new translation.

Adding a New Language

Use this section to create a translated version of the source page in one or more new languages.

• In the expanded Language Selector, click Add Language.
• A pop-up will appear listing all languages available for your site.

• Select one or multiple languages you want to translate the page into.
• Click “Add and translate.”

• A loading screen will appear confirming that the translation process has started.
• The page will refresh automatically. Open the Language Selector again to check status:

In Progress: A small spinner or progress icon will appear next to the language.

Complete: The In-progress icon will be absent, and the language page will be listed as created.

📌 If you've used AI Translation before: What's Changed

Previously: When a new language page was created, it inherited the published/draft status of the source page. If the source was published, the language page was also created as published.

Now: Language pages are always created in Draft state, regardless of the source page status. You must review and publish each language page explicitly.

Reviewing and Editing the Translated Page

Once the translation is complete, you can open and review the new language page.

• From the Language Selector, click on the newly created language to open that page.

• The page will have the same structure as the source language page, with all content translated including:
  • Body content and component text.
  • Page name.
  • Page meta information (meta title, meta description).

• Review all translated content. You can edit any field directly on the language page.
• Any manual edits you make on this language page are called local edits. These are preserved during content-only syncs (covered in Section 5).
• When you are satisfied with the content, you may proceed to publish.

Publishing and Unpublishing Language Pages

Publishing a Language Page

Language pages can be published independently of the source page or any other language page.

• Open the language page you want to publish.
• Click the Publish button.
• The publish window will display the meta information (meta title and meta description) for that specific language page only.
• Review the meta details and click Publish to confirm.

📌 If you've used AI Translation before: What's Changed

Previously: When publishing from the source page, all language pages were automatically selected and bundled into the publish action. There was no option to exclude a language page, and metadata for language pages was not shown.

Now: Each page, source, or language is published individually. When you publish a language page, only that page's metadata is shown. When you publish the source page, language pages are no longer automatically included.

Publishing the Source Page

Publishing the source page no longer automatically publishes language pages. Each language page must be published based on selection

• Open the source language page.
• Click the Publish button.
• The publish window will show the meta information for the source page, along with all the language pages with their own meta information.
• Select the applicable pages, confirm, and publish. Language pages that are not selected are not published.

Unpublishing a Language Page

Language pages can be unpublished at any time, independently of the source page.

• Open the language page you want to unpublish.
• Use the Unpublish option from the page actions menu.
• The language page will be unpublished. The source page and other language pages are not affected.

📌 If you've used AI Translation before: What's Changed

Previously: If you published source page, all the language pages were selected and included as part of the publishing journey and users didn’t have any control over selective publishing, also Individual unpublishing of language pages was not available. Unpublishing was tied to the source page.

Now: Each language page can be published and unpublished independently, regardless of the state of the source page.

Syncing Changes from the Source Page

When you update the source language page and want to reflect those changes in translated language pages, use the Sync Translation feature. Saving the source page no longer triggers any automatic sync or retranslation.

📌 If you've used AI Translation before: What's Changed

Previously: Every time you saved the source page, a prompt appeared asking if you wanted to sync. Confirming would retranslate and completely override the language page - including any local edits you had made on that language page.

Now: Saving the source page has no effect on language pages. Sync is a deliberate, separate action you initiate manually. Local edits on language pages are protected unless you explicitly choose Full Override.

Initiating a Sync

• Open the source language page.
• Open the Language Selector dropdown.
• Click Sync Translation.
• A pop-up will appear with two sync options.

Understanding Page Statuses

Before selecting pages to sync, review the status shown next to each language page:

• In Sync: In Sync
  • No changes have been made to the source since the last sync. The language page is up to date.  
• Out of Sync: Out of Sync
  • The source page has been updated since the last sync. The language page has not been retranslated to reflect these changes.
• Local Edits: Local Edits
  • A user has manually edited content directly on the language page. These edits are separate from any source changes.

ℹ️  Note

A language page can have both Out of Sync and Local Edits status at the same time — for example, if the source was updated and a user also made manual edits to the language page.

Also, this only considers the sections/component which was translated when the language page was first created. Any new section/component added or removed is not considered for this status.

Option A: Content Only Sync

Use this option when you want to push content changes from the source to language pages while preserving any local edits made on those language pages.

• In the Sync pop-up, select Content Only Sync.
• Proceed to the page selection step. Pages that are Out of Sync are automatically pre-selected, as these are most likely to need updating.
• Pages with Local Edits are flagged. You can safely include them - only the source changes will be synced, and local edits will be preserved.
• Confirm your selection and click Sync.
• A loading screen will appear confirming the sync has started.
• Once complete, open the Language Selector to verify each page's updated status.

Option B: Full Override

Use this option when the source page has structural changes, such as new components, layout changes, or significant content restructuring, that need to be fully reflected in the language page. This will discard all local edits on selected language pages.

• In the Sync pop-up, select Full Override.
• Proceed to the page selection step. Review the status of each page.
• Pages marked with Local Edits will have all manual changes permanently overwritten. A warning is displayed to highlight this.

• Select only the pages you intend to fully override. Consider deselecting pages with local edits that you want to retain.
• Confirm your selection and click Sync.
• A loading screen will confirm the process has started. The selected language pages will be fully retranslated from the current source.
• Once complete, open the Language Selector to verify the status of each page.

ℹ️  Note

Full Override cannot be undone. Any local edits on selected language pages will be permanently lost. Review your selection carefully before confirming.

Quick Reference