TMGMT DeepL Integration

Translator plugin implementing DeepL for the Translation Management Tools (TMGMT) project. Allows to use machine translation provided by DeepL to translate content.

This module requires a DeepL API subscription. See https://www.deepl.com/pro#developer for more information about plans and pricing.

The project of course also supports implicitly all the features which are provided by TMGMT like a feature-rich review process, being able to translate different sources and more.

Features

• Fast automated translation of content using the DeepL API - both endpoints (api-free.deepl.com and api.deepl.com) are supported, the endpoint is derived automatically from your API key
• translate one or multiple nodes by a few simple mouse clicks
• use advanced translation jobs management tool to submit and review translations
• use DeepL multilingual glossary functionality to specify how words and phrases are translated in specific language combinations
• support for document translation - thx @idebr (>= 2.3.0)
• support for translation context for translation jobs (>= 2.3.0)
• support for the key module (>= 2.3.0)
• use of deepl-php library (>= 2.3.0)

Requirements

• TMGMT (^1.17)
• Key (^1.19)
• deeplcom/deepl-php (^1.19), installed via composer
• a DeepL API authentication key - after signing up for an API plan on https://www.deepl.com/pro#developer it is available at https://www.deepl.com/your-account/keys

DeepL currently offers the API Developer, API Growth and Enterprise API plans. The former DeepL API Free (500.000 characters per month) and DeepL API Pro plans can no longer be purchased, but existing subscriptions keep working with this module.

Installation

The module has to be installed via composer, so the deepl-php library and all module dependencies are available:

composer require drupal/tmgmt_deepl
drush en tmgmt_deepl

Optionally enable the glossary submodule:

drush en tmgmt_deepl_glossary

Configuration

• add a new key of type DeepL API Key at /admin/config/system/keys/add and store your DeepL API authentication key there
• add a new translation provider at /admin/tmgmt/translators
• choose the DeepL API provider plugin and select your DeepL API authentication key (if no key is visible here, check for correct key type)
• set additional settings related to DeepL and save the translator
• if tmgmt_deepl_glossary is enabled, glossaries are managed at /admin/tmgmt/deepl_glossaries - grant the DeepL glossary permissions at /admin/people/permissions to the relevant roles

Upgrading from 2.2 to 2.3.0 or 2.4.0

• DeepL API Free/ DeepL API Pro translators will be deprecated and the new DeepL API translator should be used, which supports both endpoints
• you need to install the module via composer to get all dependencies
• run database update script update.php or drush updb
• login to Drupal and add a new key of type DeepL API Key at /admin/config/system/keys/add
• update or add DeepL API translator and select newly added key
• set additional settings related to DeepL and save translator

Since December 2025, we (undpaul) have been listed as an official DeepL partner. Therefore, we send a partner ID (deepl-partner-integration-undpaul) within the User-Agent header. If this is not desired, the setting can be deactivated in the translation plugin.

Sponsors

Development on TMGMT DeepL Integration is sponsored by undpaul.