Documentation

Automatically Translating Web Content

Liferay can integrate with the following service APIs to generate automatic translations of Web Content.

To use this feature, you must first set up the translation service you are using and then enable it in Liferay’s system settings. Once enabled, you can use the service to generate translations for Web Content.

Important

Only one service can be active at a given time. If you enable multiple services, the system picks the first one available.

Enabling for Google Cloud Translation

Enabling Google Cloud Translation requires an active account and a Google Cloud project with Cloud Translation API enabled. This project must also have a service account with a JSON account key. See official Google Cloud Translation documentation for more information.

When ready, follow these steps:

  1. Open the Global Menu(Global Menu), click the Control Panel tab, and go to System SettingsTranslationTranslator Using Google Cloud.

    Go to Translator Using Google Cloud.

  2. Check Enabled.

  3. Enter a valid Google Cloud service account key in JSON format.

  4. Click Save.

Enabling for Amazon Translate

Available 7.4 U9+ and GA13+

Enabling Amazon Translate requires an active Amazon AWS account. See official Amazon Translate documentation for more information.

When ready, follow these steps:

  1. Open the Global Menu(Global Menu), click the Control Panel tab, and go to System SettingsTranslationTranslator Using AWS.

    Go to Translator Using AWS.

  2. Check Enabled.

  3. Enter a valid Access Key and Secret Key.

  4. Enter your region. The default value is us-west-1.

  5. Click Save.

Enabling for Microsoft Translator

Available 7.4 U6+ and GA10+

Enabling Microsoft Translator requires an active Microsoft Azure account. See official Microsoft Translator documentation for more information.

When ready, follow these steps:

  1. Open the Global Menu(Global Menu), click the Control Panel tab, and go to System SettingsTranslationTranslator Using Azure.

    Go to Translator Using Azure.

  2. Check Enabled.

  3. Enter a valid Subscription Key and Resource Location (region).

  4. Click Save.

Using Automatic Translation

Once a translation service is enabled, auto translate buttons are added to the translation interface for Web Content.

Follow these steps to automatically translate all or only individual Web Content fields:

  1. Open the Web Content application in a Site or Asset Library.

  2. Click Actions (Actions Button) for the content you want to translate and select Translate.

    Open the Web Content translation interface.

  3. Click the top left Auto Translate button to translate all Web Content fields into the selected language.

    Click the top left Auto Translate button to translate all Web Content fields.

    Alternatively, click a field’s individual Auto Translate button (Auto Translate Button) to only translate its text.

    Click a field's individual Auto Translate button to only translate its text.

  4. Click Save as Draft or Publish when finished.