Documentation

Translating Web Content

Available Liferay DXP/Portal 7.3+

Liferay provides integrated tools for translating Web Content articles, so you can create engaging, localized content for your global users. With these tools, you can manually translate Web Content or import translations as XLIFF files.

If desired, you can enable a custom workflow to direct the review and publishing process for translations.

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.

Manually Translating Content

Note

To manually translate Web Content, users must have either View and Update permissions for the asset or Translation permissions for one or more languages. See Managing Permissions for Translation for more information.

Follow these steps to manually translate Web Content:

  1. Open the Site Menu (Site Menu), expand Content & Data, and go to Web Content.

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

    This redirects you to the translation interface, where you can view the content’s original text alongside your translation.

    The left column displays the language you’re translating from, and the right column provides editable fields you can use for your translation.

    Selecting translate redirects you to the translation interface.

  3. Select the language you want to translate.

    Important

    Users with content Update permissions can translate the original text into any language.

    Users with translate permissions can only translate the origin text into languages for which they have permission.

    Select the language you want to translate.

  4. Enter your translation for available fields.

  5. Click Publish to create a new version of the web content or initiate a workflow, if it’s enabled.

    Alternatively, click Save as Draft to save and publish your translation at a later time.

Exporting and Importing Translations

Note

To manually translate Content Page experiences, users must have either View and Update permissions for Content Pages or Translation permissions for one or more languages. See Managing Translation Permissions for more information.

With Liferay, you can export Web Content for translation as .xliff or .xlf files. You can send these files to translators and then import the translations together as a .zip file or individually as .xliff or .xlf files.

Important

Liferay supports both XLIFF 1.2 and 2.0 files. However, it may not support all features and capabilities those formats provide.

Exporting Content for Translation

Follow theses steps:

  1. Open the Site Menu (Site Menu), expand Content & Data, and go to Web Content.

  2. Click the Actions button ( Actions Button ) for the content you want to translate and select Export for Translation. This opens a modal window for configuring your export.

    Select Export for Translation.

    Alternatively, you can select multiple articles and click the Export for Translation button.

    Select multiple articles and click Export for Translation

  3. Select an export format: XLIFF 1.2 or XLIFF 2.0.

  4. Select the Web Content’s original language.

  5. Select the languages you want to translate to.

    Select the languages you want to translate the content into.

  6. Click Export.

Liferay generates a ZIP archive that contains an XLIFF file for each selected language. You can then use these files with compatible translation software.

Importing Content Translations

Follow theses steps:

  1. Open the Site Menu (Site Menu), expand Content & Data, and go to Web Content.

  2. Click the Actions button ( Actions Button ) for the translated Web Content and select Import Translation.

    Select Import Translation.

    Alternatively, you can import translations for multiple articles at once by clicking the Actions button (Actions Button) in the Application Bar and selecting Import Translations.

    Upload translations for multiple articles.

  3. Select the .xliff, .xlf, and .zip files you want to import.

    Select the translation files you want to import.

    Important

    While Liferay supports importing XLIFF files created using the Export for Translation action, it cannot guarantee the successful import of files generated by other means.

  4. Click Publish.

    If successful, Liferay displays a success message with the imported files. The Web Content is updated with all changes included in the translation files. If workflow is enabled, this change must be approved as with other content updates.

    If successful, Liferay displays a success message with the imported files.

    However, if errors occur during import, Liferay notifies you of the failing files and provides a downloadable CSV error report.

    If errors occur during import, Liferay notifies you of the failing files and provides a downloadable CSV error report.

Translating Web Content Using Third Party Services

If you’ve enabled Liferay’s integration with Google Cloud Translation, Amazon Translate, or Microsoft Translator, you can use them to automatically translate Web Content. See Using Third Parties for Translation for more information.

Additional Information