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.

• Amazon Translate
• DeepL Translate
• Google Cloud Translation
• Microsoft Translator

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 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(), click the Control Panel tab, and go to System Settings → Translation → 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 DeepL Translate

Enabling DeepL Translate requires an active DeepL account. See official DeepL support and API documentation for more information.

When ready, follow these steps:

1. Open the Global Menu(), click the Control Panel tab, and go to System Settings → Translation → Translator Using DeepL Translate.

2. Check Enabled.

3. Enter a valid API token in the Token field.

4. Enter the API URL and the DeepL Validation API.

5. Click Save.

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(), click the Control Panel tab, and go to System Settings → Translation → Translator Using Google Cloud.

2. Check Enabled.

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

4. 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(), click the Control Panel tab, and go to System Settings → Translation → 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 Actions () for the content or Page you want to translate and select Translate.

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.

   

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

   

5. Click Save as Draft or Publish when finished.

Related Topics

• Translating Web Content
• Translating Content Pages