Gettings started with AI translation

This integration allows you to translate both compositions and content entries. After the translation is complete, you can further refine the translated content before publishing.

This capability is also able to translate whole compositions.

  1. Open any composition in the editor. Ideally, pick a composition with components that have localizable parameters.

  2. Notice a new AI translation button in the siderail, click it.

    ai-translation-composition-editor
    New AI translation option in siderail
  3. The panel with AI translation will open allowing you to pick a source and target language for translation.

    ai-translation-composition-editor-panel
    Translation panel
  4. Click Translate and wait for the translation to complete.

    This process will take the whole composition including only localizable parameters and translate them to the target language according to the selected model and the prompt you provided in the integration settings.

    Webhook configuration is required

    Stop here if you haven't finished setting up the webhook, learn more about it here. The process will fail with an error if this is not taken care of.

  5. After the translation is complete, make sure to reload the composition editor first before opening the composition in the target locale. You can do this by clicking the Back and Forward buttons of your browser window.

    In this example the French Canada version of the composition is shown as translated. You can further refine the translated content before publishing.

    ai-translation-result
    This locale has been translated by AI

Entry translation#

This capability is also able to translate content entries.

  1. Open any entry in editor. Ideally, the entry must have fields that are localizable.

  2. Similar to the composition translation, click the AI translation button in the siderail.

  3. Pick the source and target language for translation and click Translate.

    This process will take the whole entry including only localizable fields and translate them to the target language according to the selected model and the prompt you provided in the integration settings.

    Webhook configuration is required

    Stop here if you haven't finished setting up the webhook, learn more about it here. The process will fail with an error if this is not taken care of.

  4. Wait for the translation to complete.

    ai-translation-entry-complete
    Entry translation is complete
  5. Reload the entry editor, switch to the target locale and see the translated content.

    ai-translation-entry-complete-fr
    Target locale translated by AI

You can trigger a workflow after an entry or composition has been translated. This can be useful if you want to further refine the translated content before publishing.

This is controlled in the callback webhook implementation. Learn more about it here.