Support website: https://community.rws.com/product-groups/trados-portfolio/rws-appstore/f/rws-appstore

Support e-mail:

Introduction

DeepL MT Provider is an application which retrieves translation results using the DeepL Translation Service. DeepL API is a paid service and you need an API Key to use the translation provider for Trados Studio or Language Cloud.  To obtain an API Key from DeepL please visit their website - https://www.deepl.com/pro?cta=header-prices

Technical Requirements

Also note that glossary support is only available with the DeepL plugin for Trados Studio 2022 and later.

Key Features

Subscriptions Supporting CAT Tool Integration

Supported: DeepL Advanced and Ultimate subscriptions.

Not Supported: Other subscription types, including DeepL Translator, Starter, DeepL API Free, DeepL API Pro, and DeepL API for Business.

Glossaries in DeepL: Understanding the Distinction

When working with DeepL, it's essential to understand the difference between glossaries created via the DeepL API through a CAT tool integration, and those created directly via the DeepL website or DeepL apps.

Glossaries Created via the DeepL API

Accessibility: These glossaries are only accessible through the specific application, tool, or plugin that created them, such as the DeepL plugin for Trados Studio.

***Integration:***They are not integrated with or synchronized to the glossaries created through the DeepL website or DeepL apps.

Management: Creation, deletion, and other management must be handled through the API or the specific tool that uses the API. Note that direct editing is not possible; changes require complete deletion of the glossary and recreation.

Glossaries Created via the DeepL Website and Apps

Accessibility: These glossaries are accessible through the DeepL website and DeepL's native apps.

Integration: They are not integrated with or synchronized to the glossaries created via the DeepL API.

Management: Creation, deletion, and other management must be handled through the DeepL website or apps.

Practical Implications

Separation of Resources: Be aware that glossaries created in one context (API or website/apps) are not accessible in the other.

Potential for Confusion: Users expecting a unified experience will need to understand that these glossaries are distinct and independent.

Current Recommendations from DeepL

Taken from this website: https://www.deepl.com/docs-api/glossaries/list-glossary-languages

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.

DeepL API Glossary Feature Support

Glossary Support is now offered via a dropdown based on supported language pair. To access it click on "Manage glossaries" from the settings page:

This will take you to a view where you can start working with glossaries:

The following features are supported

1. Add new glossary (Alt+A): When creating a glossary, you have an empty database whereby you can manually add new entriesImport glossaries (Alt+Q): Use this feature when managing glossaries between platforms. By default the name of your glossary will match the name of your imported file, but this can be changed using the edit featureExport selected glossaries (Alt+X): Supported formats being *.TSV & *.CSVImport entries into selected glossaries (Alt+D): This supports the import of a file into existing glossariesDelete selected glossaries (Delete): this will delete your selected glossariesEdit glossary (Alt+E): opens a view to edit the selected glossary

Once your glossary has been created, you can't change the name of your glossary.  However you can edit term entries

When editing your glossary the following features are supported:

• Delete entry
• Add entry
• Import into Glossary
• Edit entry

Glossary Restrictions

1. Import file format: The format of the import can either be *.TSV & *.CSV (delimited by either a semi colon or comma). The placement of source / target terms within your file, should directly correlate with the supported language direction defined during importCommon Restrictions for All Glossary Formats
2. Duplicate source entries are not allowed
3. Neither source nor target entry may be empty
4. Source and target entries must not contain any C0 or C1 control characters (including, e.g., "\t" or "\n") or any Unicode newline
5. Limits imposed: You can create up to 1,000 glossaries. Please keep in mind that the maximum size limit for a glossary is 10 MB and each source/target text as well as the name of the glossary is limited to 1024 UTF-8 bytes.Editing existing DeepL API Glossaries is not supported by DeepL. You can implement the edit functionality yourself by creating a new glossary with the modified entries and deleting the old glossary.Language Support: Not all languages supported by the plugin for translation have glossary support. If you have a problem please make sure you check the supported languages here: https://www.deepl.com/docs-api/glossaries

New Features

Tag Handling

• tag_handling: Determines how tags should be processed.
• Options:
• xml: Enable XML tag handling.
• html: Enable HTML tag handling.

Ignore Tags

• ignore_tags: Comma-separated list of XML tags indicating text that should not be translated.

NewLine Handling

The NewLine Handling setting allows you to control how DeepL processes line breaks (\n) in your text. Choosing the right option can help prevent translation errors, such as duplicated words or incorrect sentence splitting.

Available Options:

Default (Recommended for most users)

DeepL automatically chooses the best method based on the content type:

• For HTML/XML content → Ignores newlines, splitting only at punctuation.

• For Plain text → Splits sentences at both punctuation and newlines.

• Use this if you're unsure which setting to apply.

No Splitting (Preserves original structure)

• Keeps the text structure as is and does not split sentences at punctuation or newlines.

• Use this if you want to maintain formatting exactly as in the source text.

No Newlines (Ensures smooth sentence flow)

• Ignores all newlines and splits sentences only at punctuation marks.

• Use this to improve translation accuracy by preventing unexpected line breaks from affecting sentence structure.

How the plugin works

After the plugin has been installed you can access it in Studio by going to yourProject Settings -> All Language Pairs->Translation Memory and Automated Translation and then click on the Use... button to expand the options:

A new window will appear where you can introduce your API Key . The API Key text box is a required field, so if you don't fill it and click OK the window will not close and instead an warning message will appear. It's also worth noting that if you cannot close the window after adding your key it may help to add a space to the end of the key and then delete it. That should activate the OK button:

To close the window use "Cancel" button or "X" from the top right of the window

Troubleshooting:

Sometimes errors can be reported when trying to get a translation result from DeepL. This may be related to firewall restrictions which can be resolved by whitelisting the following domains:

www2.deepl.com

api.deepl.com

For more details on this you may find this link helpful:

https://gateway.sdl.com/apex/communityknowledge?articleName=000013232