DeepL glossaries can now target language variants like pt-BR, en-US and zh-Hant (November 3, 2026)
DeepL glossary dictionaries can now target one variant, like pt-BR or de-CH. One glossary can't mix a base language and its variants.
Your keys
0 of 1 ready
Create each key on its own page, paste it below, then copy the finished lines into your project's .env file. What you paste stays in this tab. It is never sent to Wirestack or saved.
- DeepL API keyDEEPL_AUTH_KEYGet key
Sign in, open API Keys & Limits, click Create key and copy it from the popup. The Free API plan works.
What you get
On November 3, 2026 DeepL added glossaries for language variants. A glossary holds one dictionary per language pair. Until now a dictionary could only target a base language such as pt, and it covered every variant of that language. Now you can also make a dictionary for one variant, such as pt-BR or pt-PT. Terms that differ between Brazil and Portugal can sit side by side in one glossary.
- Supported variant targets:
de-CH,de-DE,en-GB,en-US,es-419,es-ES,fr-CA,fr-FR,pt-BR,pt-PT,zh-Hansandzh-Hant.GET /v3/languages?resource=glossaryreturns the current list. - Source languages stay base languages. Only the target can be a variant.
- How they apply: a base dictionary such as
destill applies to every variant of German. A variant dictionary such asde-CHapplies only when the request'starget_langis exactlyde-CH. - One rule per glossary: within one glossary, each language uses either the base language or its variants as targets, never both.
de-CHandde-DEcan be combined.deandde-DEcan't. Breaking this rule returns a400error.
Prerequisites
- A DeepL API key in
DEEPL_AUTH_KEY - The v3 glossary endpoints (
/v3/glossaries). Free plan keys usehttps://api-free.deepl.com, paid keys usehttps://api.deepl.com
