Using Third Parties for Translation

Available Liferay 7.4 U15+ and GA15+

Liferay can integrate with these translation providers to generate automatic translations of content pages and web content. Translator Using AI Hub is the exception: it translates in the Liferay CMS editor instead of in the translation interface the other four providers use.

• Amazon Translate
• DeepL Translate
• Google Cloud Translation
• Microsoft Translator
• Translator Using AI Hub

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 () and navigate to Control Panel → 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 () and navigate to Control Panel → 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 () and navigate to Control Panel → 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.

Note

The Google Cloud Translation Basic API supports up to 128 text segments per request. For most content, this is sufficient. However, when translating complex pages with many fields or fragments, you may reach this limit.

In these cases, you can translate fields individually, simplify the content structure, or consider using a different translation provider with higher limits.

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 () and navigate to Control Panel → System Settings → Translation → Translator Using Azure.

2. Check Enabled.

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

4. Click Save.

Enabling Translator Using AI Hub

Liferay DXP 2026.Q3+ Release Feature (LPD-62272)

AI Hub is Liferay’s own product rather than a third party, but it connects through the same System Settings translation provider entry as the other four services.

Enabling Translator Using AI Hub requires an active AI Hub account connected to your Liferay DXP instance. See Integrating AI Hub with Liferay DXP. It translates with the model configured in AI Hub, so it takes a single Enabled checkbox and no credentials. It’s disabled by default, and the entry appears in System Settings only when AI Hub is enabled for the virtual instance.

Important

This provider uses a different workflow from the other four. It moves translation into the Liferay CMS editor, where an Auto Translate With AI button beside the language picker replaces the Auto Translate action. Everywhere else, automatic translation stops working: the Auto Translate buttons in the translation interface described in Using Automatic Translation, and the Auto Translate action in editors outside Liferay CMS, both return “There is a problem with the translation service. Please contact your administrator.” Manual translation and XLIFF import and export are unaffected. See Translating Content with AI Hub.

To enable AI Hub translations, follow these steps:

1. Disable any other translation service, because when more than one is enabled the system uses the first one available.

2. Open the Global Menu () and navigate to Control Panel → System Settings → Translation → Translator Using AI Hub.

3. Check Enabled.

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. These buttons apply to the four third-party translation services. When Translator Using AI Hub is the active provider, they return an error, and you translate in the Liferay CMS editor instead. See Translating Content with AI Hub.

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
• Translating Content with AI Hub