Kirby Tools
v3.11.0Hub

DeepL

Translate via DeepL with native API support – tunable request options, language-code overrides, and a free tier.

DeepL provides industry-leading machine translation with excellent quality for European languages. DeepL offers a free tier – see DeepL API pricing for current limits.

Setup

To use DeepL as your translation provider, add your API key to the global configuration:

config.php
return [
    'johannschopplich.content-translator' => [
        'DeepL' => [
            'apiKey' => env('DEEPL_API_KEY')
        ]
    ]
];
The plugin automatically detects whether you're using a free or pro API key and uses the appropriate endpoint.

Request Options

DeepL offers a variety of options to customize the text translation API endpoint. To learn more about the available options, please refer to the DeepL translate text parameters.

To set custom request options for the DeepL API, add them to the plugin's requestOptions configuration:

config.php
return [
    'johannschopplich.content-translator' => [
        'DeepL' => [
            // All available options can be found in the DeepL API documentation:
            // https://developers.deepl.com/docs/api-reference/translate#request-body-descriptions
            'requestOptions' => [
                // Lean towards formal language
                'formality' => 'more'
            ]
        ]
    ]
];

Supported Languages

DeepL supports the following languages for translation:

Source Languages

Arabic (AR), Bulgarian (BG), Chinese (ZH), Czech (CS), Danish (DA), Dutch (NL), English (EN), Estonian (ET), Finnish (FI), French (FR), German (DE), Greek (EL), Hebrew (HE), Hungarian (HU), Indonesian (ID), Italian (IT), Japanese (JA), Korean (KO), Latvian (LV), Lithuanian (LT), Norwegian Bokmål (NB), Polish (PL), Portuguese (PT), Romanian (RO), Russian (RU), Slovak (SK), Slovenian (SL), Spanish (ES), Swedish (SV), Thai (TH), Turkish (TR), Ukrainian (UK), Vietnamese (VI)

Target Languages

All source languages plus regional variants:

  • English: British (EN-GB), American (EN-US)
  • Portuguese: Brazilian (PT-BR), European (PT-PT)
  • Spanish: Latin American (ES-419)
  • Chinese: Simplified (ZH-HANS), Traditional (ZH-HANT)
The plugin automatically resolves regional variants from your Kirby language's LC_ALL locale setting. For example, if your locale is en_GB, DeepL will receive EN-GB as the target language.

View Button & Section Configuration

Per-blueprint controls for the view button and section – override defaults, scope translatable fields, customize labels.

AI Translation

Combine Content Translator with Kirby Copilot for AI-powered translations using models from OpenAI, Google, Anthropic, or Mistral.