Documentation

Using Third Parties for Translation

Available Liferay 7.4 U15+ and GA15+

Liferay can integrate with the following service APIs to generate automatic translations of Content Pages and 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 Content Pages and Web Content.

Important

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

Enabling 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 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 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 Content Pages and Web Content.

Follow these steps to automatically translate fields:

  1. Open the Pages or Web Content application.

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

    Open the Web Content translation interface.

  3. Use the language flags to select the languages you want to translate.

    Note

    The languages available for translation are determined by your instance’s localization settings. See Initial Instance Localization and Virtual Instance Localization for more information.

  4. Click the 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.

  5. Click Save as Draft or Publish when finished.