Page tree
Skip to end of metadata
Go to start of metadata

The Content Translation Support Extended (CTSX) module enables you to translate content automatically. This module comes with several apps which are used to manage the translation tasks.


Maven is the easiest way to install the modules. Add the following dependencies to your bundle:

<!-- API and base classes that support the CTSX Translator modules. -->

<!-- Contains the apps for managing translations. Needed only before 3.0 version -->
<!-- Batches, History, Queues, and Comparison. -->

<!-- For OpenJDK 11 CTE 3.0 you will need to have the following dependencies -->
<!-- in your web app lib folder-->


Translation service

In addition to the core and apps modules, one (or more) of the translator modules should be installed:

3.0.2Magnolia 6.1
3.0.1Magnolia 6.1
3.0Magnolia 6.1


Magnolia 5.6
2.0.2Magnolia 5.6
2.0.1Magnolia 5.6

Magnolia 5.6


Content Translation Support Extended (CTSX) enables you to translate content automatically over a translation provider ensuring a more accurate translation. Translation is done from a base language, typically English, to a target language. The base language should exist as content within your website or content app as properties. The target languages should be configured in your site definition. See Enabling multilanguage content for more information.

Translation providers

There are three translation providers to choose from: Google, Microsoft Translator and To make use of the translation functionality, a user account is required for the chosen provider.

A translator module connects Magnolia to translation services. The behavior of the service depends on the translation service selected.


Returns directly the translated result for each translation request.

  • Google
  • Microsoft

Not support to translate the languages which contain the country information yet.

  • Translate from English to Germany (Supported)
  • Translate from English, United Kingdom to Germany, Switzerland (Not supported yet)

Does not return the translated result for each translation request. A second request is required to get the translated result.


Support to translate the languages which contain the country information.

  • Add the country information for locales in the site definition (e.g: country=GB for English, United Kingdom)
  • Mix the country information with fallbackLocale (or defaultLocale) property for setting the source language in the site definition (e.g: fallbackLocale=en_GB for English, United Kingdom)

Each translator has a common set of properties.



When true the content review process (workflow) is bypassed.



Definition class for the translator to be used.



The display name of the configuration in Magnolia.



Set the translator to be the default.



Enables or disable the configuration with true or false.



Implementation class for the translation service.

Translation Extend app

The module comes with the Translation Extend app which can be found under the tools menu of the appluancher. This app extends the functionality of Content Translation in the sense that translations can now automatized. It would still be possible to export those automatized translations from the Content Translation app after receiving them. 

Translation subapps

The app is made up of several subapps for managing translation files and submissions.

  • Batches: In the Batches subapp users can
    • Add a new or edit an existing batch.
    • Submit a batch for translation.
    • Get the history of the batch.
    • Cancel a batch submission.
    • Reload an exiting batch.
  • Histories: Allows for viewing and managing the batch histories.
  • Queues: Allows for managing the translation submission.
  • Comparison: Allows you to compare between original value and translated value before importing or reject.

Translation status

Once a batch is created it has a status. The status is visible from Batches subapp.

OPENCreated and not yet submitted
PROCESSINGProcessing and waiting to be submitted or imported
SUBMITTEDSubmitted to the translation provider
TRANSLATEDTranslated by the translation provider and was received
APPROVEDThe translation has been approved by the reviewer
IMPORTEDThe content was imported
REJECTEDThe translation has been rejected by the reviewer
REOPENEDReopened after going through review step
EMPTYThe resource has no i18n items


This module provides a workflow for users to review and approve translated content. If the setting autoTranslationAllowed is true then the content is imported directly without a review step. Otherwise the content review workflow process is started.

The workflow is identical in nature to the 4-eye content approval workflow used for the Pages app. In this case the editor is the translation provider an the reviewer can be any person in the group. To configure your desired group, change the property here: /modules/content-translation-support-ext-core/tasks/reviewTranslation/groups@publishers

Message views

Workflow message views define how messages display in the Pulse during translation workflow. See Message view definition for more.

Message views are configured here: /modules/content-translation-support-ext-core/messageViews

Work item handlers

The mapping is based on the work item name which is added to the jBPM process definition. There are two handlers configured for the workflow process.

  • approve: Handles importing translated content after approval.
  • reject: Handler for content rejection

Work item handlers are configured here: /modules/content-translation-support-ext-core/workItemHandlers

Translation jobs

The core module installs three scheduled jobs to automate the translation process. The translation is submitted to the translation provider. In the case of, a second request is required to retrieve the translation results. Finally, the translation is either directly imported or the workflow process is initiated.

The jobs are configured under: /modules/scheduler/config/jobs


The executeSubmissionTranslationCommand sends translation submission request to provider.

# Configuration shown in YAML but must exist as a JCR Node.
  catalog: workflowTranslation
  command: threadPoolSubmissionCommand
  cron: 1/60 * * * * ? # set to execute every minute at 1 second past the minute
  description: Output, Send, Update translation batch
  enabled: true
    batchSize: 100 # define how many tuples we retrieve at each execution of the job
    maxAttempt: 10 # define the max retry for each item
    poolSize: 10 # define the size of the thread pool


The executeGetTranslationCommand is for asynchronous translation. For translating services that require a second request to retrieve the translations you will need to use this job as well.

# Configuration shown in YAML but must exist as a JCR Node.
  catalog: workflowTranslation
  command: threadPoolGetTranslationCommand
  cron: 5/60 * * * * ? # set to execute every minute at 5 seconds past the minute
  description: Get translation from provider
  enabled: true
    batchSize: 100 # define how many tuples we retrieve at each execution of the job
    maxAttempt: 10 # define the max retry for each item
    poolSize: 10 # define the size of the thread pool


The executeImportTranslationCommand imports the translation immediately  or starts the workflow. The behavior is set by autoTranslationAllowed property in the translator configuration.

# Configuration shown in YAML but must exist as a JCR Node.
  catalog: workflowTranslation
  command: threadPoolImportCommand
  cron: 0/30 * * * * ? # set to execute every 30 seconds
  description: Import or create import workflow
  enabled: true
    batchSize: 100 # define how many tuples we retrieve at each execution of the job
    maxAttempt: 10 # define the max retry for each item
    poolSize: 10 # define the size of the thread pool

What is exported and imported

By default, text and rich text fields are included in export files. Additional field types can be registered here: /modules/content-translation-support-ext-core/config/propertiesToTranslateFinder. Add another property with the value set to the definition class of the field that should be included.

In addition to registration, the child fields of the composite field should have an i18n property set to true. It is not necessary for the composite field itself to have an i18n property.

    - name: tabText
        - name: composite 
          label: Sample Composite
          class: info.magnolia.ui.form.field.definition.CompositeFieldDefinition
            - name: title
              i18n: true
              label: Title
              class: info.magnolia.ui.form.field.definition.TextFieldDefinition
            - name: subtitle
              label: Subtitle
              class: info.magnolia.ui.form.field.definition.TextFieldDefinition

Notification Email

Magnolia uses Mail module to send a notification email to submitter in case of errors. The template provided is here. The notification email template is configured here: /modules/mail/config/templatesConfiguration/translationNotificationTemplate



  • This module is at INCUBATOR level.

  • The frequency of the scheduled jobs may be high for most. For more information on how to configure the cron property see: Cron Expressions.
  • There is a NullPointerException when translating multilanguage in Magnolia 5.6.6+. Due to changes on 5.6.6, the registered translators were missing after changing language. 

    Restarting the server will help to reload the translator. Doing so should help resolve the issue.

  • NoSuchDefinitionException when clicking on review action in translation workflow after upgrading to 2.0.2 There was a missing update of the configuration for messageViews node after consolidating translation comparison app with others.

    Navigate to: /modules/content-translation-support-ext-core/messageViews/reviewTranslation/actions/review 

    Add properties: appName=extendContentTranslation and subAppName=comparison



  1. Does this work with 5.7? If so can you add it to the version table at the top?

    1. Yes, for 5.7 I believe you should be using 2.9-SNAPSHOT. Recently Adrien Manzoni did some updating but no official release yet. Still waiting on feedback.