Manage Glossaries

The glossary functions allow you to create, inspect, and delete glossaries. Glossaries created with the glossary function can be used in translate requests by specifying the glossary_id parameter. If you encounter issues, please let us know at support@DeepL.com.

The DeepL API supports glossaries in any combination of two languages from the following list, enabling a total of 120 possible glossary language pairs:

• DA (Danish)
• DE (German)
• EN (English)
• ES (Spanish)
• FR (French)
• IT (Italian)
• JA (Japanese)
• KO (Korean)
• NB (Norwegian (bokmål))
• NL (Dutch)
• PL (Polish)
• PT (Portuguese)
• RO (Romanian)
• RU (Russian)
• SV (Swedish)
• ZH (Chinese)

The maximum size limit for a glossary is 10 MiB = 10485760 bytes and each source/target text, as well as the name of the glossary, is limited to 1024 UTF-8 bytes. A total of 1000 glossaries are allowed per account.

When creating a glossary with target language EN, PT, or ZH, it's not necessary to specify a variant (e.g. EN-US, EN-GB, PT-PT, PT-BR, or ZH-HANS). Glossaries with target language EN can be used in translations with either English variant. Similarly PT, and ZH glossaries can be used in translations with their corresponding variants.

Glossaries created via the DeepL API are distinct from glossaries created via the DeepL website and DeepL apps. This means API glossaries cannot be used on the website and vice versa.

Note that glossaries are immutable: once created, the glossary entries for a given glossary ID cannot be modified.

As a workaround for effectively editable glossaries, we suggest to identify glossaries by name instead of ID in your application and then use the following procedure for modifications:

• download and store the current glossary's entries,
• locally modify the glossary entries,
• delete the existing glossary,
• create a new glossary with the same name.

This category contains 6 nodes.