All settings are located in the Shopware admin under Settings > System > Translation with DeepL.
| Setting |
Description |
| DeepL API Token |
The API key from your DeepL account (Pro or Free). Without a token no data is transmitted. |
| Use DeepL Free API |
Enabled by default (free DeepL plan). Controls the correct base URL (api-free.deepl.com vs. api.deepl.com). Disable when using a Pro API key. |
| Default Glossary ID |
Optional DeepL glossary ID for consistent translations. Used when a job does not specify its own glossary. Details: FAQ: Glossaries. |
| Ignore characters |
Space-separated list of characters that stay unchanged (e.g. ► ✅ ✔ ® ©). |
| Dummy text patterns |
Texts containing these patterns are not translated (one pattern per line). Lorem Ipsum and similar placeholders are detected automatically. |
| Dummy text threshold (%) |
Minimum share of detected dummy words (0-100%) to classify text as dummy. At 0, a single match blocks. |
| Replace URLs during translation |
JSON object with static URL replacements, e.g. {"impressum": "imprint"}. Useful for pages that keep the same path in every language. |
| Setting |
Description |
| Activated category custom fields |
List of custom field names to translate for categories |
| Activated product custom fields |
List of custom field names to translate for products |
| Setting |
Description |
| Custom CMS slot configuration paths |
JSON paths to additional translatable CMS slot configurations (e.g. content.value), useful for custom element bundles |
This plugin sends shop content (e.g. product texts, category texts) to the DeepL API operated by DeepL SE for translation. Please note:
- No transmission before configuration: data transfer only starts once a DeepL API token has been stored and a translation job has been started.
- Content may contain personal data: check whether your texts contain personal data (e.g. names in descriptions) and only transfer the fields you actually want to translate.
- Data processing: a data processing agreement (DPA) with DeepL SE may be required. DeepL privacy provides details on data processing, storage locations and contracts.
- Free vs. Pro: the privacy terms of the DeepL free plan apply to the Free API; the Pro plan states that submitted texts are not used to train models. Note the currently valid DeepL terms, see also FAQ: Free vs. Pro.
- Transmission channel: texts are transmitted via HTTPS (TLS encrypted). Original and translated texts are stored in the local translation cache of the shop database and removed on complete uninstallation.
