Skip to main content
Version: 2025.2

DeepL

Setup​

Create or use an existing DeepL API Account, get necessary configuration values from it and apply it via configuration user interface or via configuration file as follows.

pimcore_translations_provider_interface:
    deepl:
        api_url: '<TRANSLATE>' # e.g. https://api-free.deepl.com/v2/translate
        token: '<YOUR_API_TOKEN>'
        glossary: 'on'
        glossary_url: '<GLOSSARY_LANGUAGE_PAIRS_ENDPOINT>' # e.g. https://api-free.deepl.com/v2/glossaries

Glossary​

The adapter supports usage of glossary during translation process but there is no user interface to create glossary entries. To use glossaries, you have to create them directly via DeepL API so that they will be used during translation process. Details see DeepL Docs.

Configuration of available languages in DeepL​

To configure available languages in DeepL, you can use the languages configuration option. This specifies the source and target languages that Pimcore should consider available for translation with DeepL. The bundle includes a default configuration with all languages supported by DeepL at that time.

pimcore_translations_provider_interface:
    deepl:
        language:
            source: [
                'EN',
                'PT',
                'ZH',
                'AR',
                'BG',
                'CS',
                'DA',
                'DE',
                'EL',
                'ES',
                'ET',
                'FI',
                'FR',
                'HU',
                'ID',
                'IT',
                'JA',
                'KO',
                'LT',
                'LV',
                'NB',
                'NL',
                'PL',
                'RO',
                'RU',
                'SK',
                'SL',
                'SV',
                'TR',
                'UK']
            target: [
                'EN',
                'PT',
                'ZH',
                'AR',
                'BG',
                'CS',
                'DA',
                'DE',
                'EL',
                'ES',
                'ET',
                'FI',
                'FR',
                'HU',
                'ID',
                'IT',
                'JA',
                'KO',
                'LT',
                'LV',
                'NB',
                'NL',
                'PL',
                'RO',
                'RU',
                'SK',
                'SL',
                'SV',
                'TR',
                'UK',
                'EN-GB',
                'EN-US',
                'PT-BR',
                'PT-PT',
                'ZH-HANS',
                'ZH-HANT']