Setting Up Languages in CMS

AI Translation – Complete User Guide


AI Translation – Complete User Guide....................................................................................... 1

Introduction........................................................................................................................... 1

How It Works.......................................................................................................................... 1

Page-Level Translation (Not Full Site Translation).................................................................. 1

How to Create Language Pages.............................................................................................. 1

How to Add a New Component to a Translated Page............................................................ 5

Adding Standalone Components (Primary or Secondary Language)..................................... 7

What is Sync?......................................................................................................................... 7

Supported Addon Components for AI Translation............................................................... 10

Key Points to Remember...................................................................................................... 13

FAQs..................................................................................................................................... 14

 

Introduction

AI Translation allows you to easily create multilingual versions of your website pages using built-in AI support within Page Studio. Instead of manually recreating each page in another language, the system automatically generates a translated version based on your primary language page.

 

How It Works

When you add a new language to a page, the system:

·         Uses your primary language page as the source

·         Automatically translates supported content components

·         Creates a separate language version of that page

·         Allows you to review, edit, and publish it

If you later update the primary page, you can use the Sync feature to update the translated pages accordingly.

Page-Level Translation (Not Full Site Translation)

AI Translation works at the page level, which means:

·         Each page must be translated individually

·         You have full control to review and publish each translated page separately

This approach ensures better quality control, accurate content review, and proper link management before publishing.

 

How to Create Language Pages

Step 1 – Open the Page

Open the required page in Page Studio Editor.
From the side drawer, click Add Languages.

Step 2 – Language Popup

A popup widget will appear showing all the pre-configured languages available for the site.

Step 3 – Select Language

Select the language from the dropdown and click Save.
This submits the page for AI-backed translation.

💡 Please allow time for the AI to process all components and generate translated records. Processing time depends on:

·         Page content size

·         Number of components

·         Selected languages

If translation fails (very rare case):

·         Remove the language

·         Add it again

 

Step 4 – Language Appears in Drawer

The newly added language will now be visible in the side drawer.

Step 5 – Language Limitation

Users can only add languages that are pre-configured in the CMS.

Step 6 – Delete / Re-trigger Translation

To delete a translation page or regenerate it:

·         Click the Delete button next to that language.

💡 This is a permanent action. There is no rollback.

Step 7 – Publish

Once translation completes:

·         Close the drawer

·         Publish the page

Step 8 – Access the Translated Page

Open the translated page by:

·         Clicking the language name
OR

·         Changing the language from the top dropdown

You will see the entire page translated.

As a best practice:

·         URL-related fields are excluded from translation to avoid broken links.

·         After reviewing translated content, update links if you want them to point to translated URLs instead of primary language URLs.

Step 10 – Publish Translation Page

Publish the translated page to make it live.

 

 

 

 

 

How to Add a New Component to a Translated Page

Step 1 – Open Language Page

Open the page in Page Studio and switch to the desired language (or open it directly from the page list).

Step 2 – Add Section

Click Add Section and select the required component.

 

Step 3 – Add Translated Content

Edit the component and enter the content.

Since the component is added directly in the language page:

·         The system will NOT auto-translate it.

·         Content must already be translated before adding.

Step 4 – Publish

Publish the page.


Adding Standalone Components (Primary or Secondary Language)

Users can add/remove components without affecting other language pages.

Steps:

1.      Open the page in Page Studio.

2.      Navigate to the specific language page.

3.      Click Add Section to add a component.

4.      To remove, delete it like a normal component.

5.      Publish the page.

This affects only the selected language.
To remove from all languages, repeat the process or use Sync (explained below).


What is Sync?

When saving the primary language page, a Sync popup appears.

Sync is used to align all translated pages with the primary language page.

When to Use Sync

If:

·         Language pages already exist

·         You updated the primary page

·         You want all languages to reflect the changes

Steps to Sync

Step 1 – Select Languages

·         Choose specific languages from dropdown
OR

·         Select “Sync my language sites” to select all

Step 2 – Click Update

Click Update to start the sync process.

Step 3 – Auto Refresh

The page refreshes once sync completes.

Step 4 – Publish

Publish:

·         Primary language page

·         All language pages


What Happens During Sync?

·         All components become identical to primary language.

·         Extra components added manually will be removed.

·         Missing components will be added.

·         URL structure will reset to primary language structure.

·         Page name & metadata will be re-written by AI.

·         All content will be re-written by AI.

·         Manual edits in translated pages will be overridden.


Supported Addon Components for AI Translation

Supported:

·         Form Builder Component

·         Events Component

·         Blog Component

Not Supported:

·         FAQs Component


Form Builder Component

To translate Forms:

1.      Add the form component in the primary language.

2.      Save with Sync enabled.

3.      AI translates the form.

4.      Open each translation page.

5.      Click Edit Form.

6.      Only Label field is editable in translation pages.

7.      Save the form.

8.      Publish the page.

Important Notes:

·         No Draft Mode supported.

·         Clicking Save updates the live form if the page is already published.

·         Standalone addition in translation pages is NOT supported.

·         To re-add after deletion → perform Sync.

💡 Pro Tip:
To sync only the form without affecting other content:

·         Create a dummy page

·         Add same form component

·         Perform Sync


Events Component

·         Cannot be added directly to translation pages.

·         Must exist in primary language and be synced.

·         Supports English only.

·         If removed from secondary language, must Sync to restore.


Blog Component

Same behaviour as Events:

·         Add in primary language

·         Sync to other languages

·         English-only support

·         Must Sync to restore if removed


FAQs Component

Currently not supported in AI Translation pages.


Key Points to Remember

·         Sync overwrites manual edits.

·         Removing addon components is irreversible (unless synced again).

·         Form updates in primary require Sync + Save on language pages.

·         Always verify URL structure after Sync.

·         Update translated page links manually if required.

·         Large pages take longer to translate.

·         No bulk translation at site level (page-by-page only).


If Translation Fails

Very rare scenario.

Step 1

Click the Retry button shown on failure.

Step 2

If it fails again:

·         Remove the language

·         Add the language again

Step 3

If issue persists:

·         Contact Engineering Support for root cause investigation.


FAQs

Find answers to commonly asked questions about AI Translation, language page creation, Sync functionality, supported components, and troubleshooting scenarios.

1. How long does AI translation take?

Translation time depends on:

·         Page content size

·         Number of components

·         Number of languages selected

Large pages with many records may take longer. Please allow sufficient processing time.


2. Can I generate translations for multiple pages at once?

No.
Currently, AI translation must be triggered page by page. Bulk site-level translation is not supported.


3. What happens if translation fails?

This is rare. If it happens:

1.      Click the Retry button.

2.      If it still fails, remove the language and add it again.

3.      If the issue persists, contact Engineering Support.


4. Will Sync overwrite manual edits on language pages?

Yes.
When you perform a Sync:

·         All manual edits on translated pages will be overwritten.

·         AI will re-write content to match the primary language.

·         Extra components will be removed.

·         Missing components will be added.

Use Sync carefully.


5. Does Sync update URLs and metadata?

Yes. Sync will:

·         Rewrite the URL structure to match the primary language.

·         Update folder structure.

·         Update page name and metadata.

If a language page had a custom URL (e.g., Spanish), it will revert to the primary language version.


No.
URL-level fields are excluded from translation to avoid broken links.

After translation:

·         Users must manually update links if they want them to point to translated URLs instead of the primary language URLs.


7. Can I add a component directly to a translated page?

Yes, but:

·         The content must already be translated.

·         The system will NOT auto-translate newly added components in language pages.


8. Can I add all addon components directly to translated pages?

No.

Component

Direct Add in Language Page

Notes

Form Builder

Not Supported

Must be added in primary and synced

Events

Not Supported

English only

Blog

Not Supported

English only

FAQs

Not Supported

Not supported in AI Translation


9. What happens if I remove an addon component from a language page?

The action is not reversible manually.

To restore:

·         You must perform a Sync from the primary language page.


10. How does Form Builder translation work?

·         Form must be added in the primary language.

·         Sync must be enabled.

·         After translation, open each language page.

·         Only the Label field is editable in translated forms.

·         You must save the form on the language page to make it visible.


11. Does Form Builder support draft mode?

No.
Form Builder does not support draft mode.

If the page is already published:

·         Clicking Save updates the form in live immediately.


12. Can I remove a language page?

Yes, but:

·         Deleting a language page is permanent.

·         There is no rollback.


13. What happens when I add a standalone component in only one language?

The change applies only to that selected language.

Other language pages remain unaffected.


14. Will Sync remove extra components added in translated pages?

Yes.
Sync makes all language pages identical to the primary language page.

Extra components will be removed.


15. Why is my Events or Blog component showing only English?

Because:

·         Events and Blog components currently support English only.

·         Even on translated pages, content remains in English.


16. Can I generate translation for languages not configured in CMS?

No.
Only pre-configured CMS languages can be generated.


17. What should I verify after Sync?

After Sync:

·         Verify URL structure

·         Check for broken links

·         Review metadata

·         Publish all language pages


18. If I update the form in the primary language, how do I reflect it in other languages?

Steps:

1.      Perform Sync.

2.      Open each language page.

3.      Edit and Save the form.

4.      Publish each page.


19. Does deleting a translation page affect the primary page?

No.
Deleting a language page only affects that specific language.


20. Is translation automatic after adding a new component to primary?

No.
You must:

·         Save with Sync enabled
OR

·         Manually perform Sync later