Migration Guide: Language Pack Plugin → Integrated Translation Handling
Starting with Shopware 6.7.3.0, translations are managed directly in Shopware. From 6.8.0.0, the Language Pack plugin will no longer be compatible. Follow this guide to migrate safely.
What changes
From Shopware 6.7.3.0 onward
- Translations can be installed via Shopware itself. The Language Pack plugin is not required to fetch the newest Shopware translations.
- A new CLI command is available:
bin/console translation:install --locales it-ITThe Language Pack plugin still works but is not recommended.
Languages now have an active flag which can be toggled in the Administration under
Settings → Languages.Languages installed/managed from other sources do not need to register their locales in the admin anymore.
Other translation plugins or snippets in themes are not affected and can still be used alongside the integrated handling.
Shopware 6.8.0.0 and later
- The Language Pack plugin is not compatible.
- The integrated language handling should be used to fetch the newest Shopware translations.
- Other translation plugins or snippets in themes are not affected and can still be used alongside the integrated handling.
- The Language Pack plugin is not compatible.
Migration paths
1. You are not using the Language Pack plugin
- Nothing changes.
- To install additional languages, use the CLI command:
bin/console translation:install --locales <locale-code>Example: bin/console translation:install --locales it-IT,fr-FR will install Italian and French.
2. You are currently using the Language Pack plugin
Before you start, update the Language Pack plugin to 5.79.0 or later and back up your database. Language Pack 5.78.0 and earlier can delete the custom snippets of a
LanguagePacksnippet set during the migration. Custom snippets that were already deleted can only be restored from a backup.Run the translation command and install every language you are using in your shop:
bashbin/console translation:install --locales <locale-code>,<locale-code>The command uses the same source (translate.shopware.com) as the Language Pack plugin but is updated more frequently. So it's essentially identical – or even more up to date!
Make sure that all languages you need are active in the Administration:
Settings → LanguagesCreate base snippet sets for used languages
- If you're on Shopware 6.7.7.0 or later, this is done automatically. With Language Pack 5.79.0 or later, the
LanguagePacksnippet set becomes theBASEsnippet set, e.g.LanguagePack en-USbecomesBASE en-US, and keeps your custom snippets. - If you're on Shopware 6.7.6.0 or earlier, for each language in use, create a base snippet, e.g.
BASE en-USfor English (US).
- If you're on Shopware 6.7.7.0 or later, this is done automatically. With Language Pack 5.79.0 or later, the
Change all sales channel domains to use the base snippet sets.
- If you're on Language Pack 5.37.1 or later, this is done automatically.
- If you're on Language Pack 5.37.0 or earlier, open each sales channel, scroll down to the domains and change the snippet set from
LanguagePacktoBASE, e.g.:LanguagePack en-UStoBASE en-US.
It is recommended to uninstall and remove the Language Pack plugin after
translation:installsucceeded for all locales. With Language Pack 5.79.0 or later, your custom snippets created in the snippet module move to theBASEsnippet set of their language, also when you uninstall the plugin with all its data. If you're on Shopware 6.7.6.0 or earlier, uninstall the plugin with all its data. Only then do your custom snippets move to theBASEsnippet set. If both snippet sets contain the same snippet key, theBASEvalue is used and theLanguagePacksnippet set is kept with the other value.
New installations
- During a fresh Shopware installation, you can select the desired languages directly in the installer. They will be downloaded and installed automatically.
- No additional language plugin is required.
More information
- Additional details about the new translation handling are available in the integrated language handling guide.
Common problems and troubleshooting
Can't remove Language Pack: a foreign key constraint fails (`shopware`.`sales_channel_domain`…
Starting with Shopware 6.7.7.0 and Language Pack 5.37.1, the migration process was improved. If you encounter this issue, please update Shopware to >= 6.7.7.0, Language Pack to >= 5.37.1, remove the translation files created from running the command and run the command again. Or follow the updated migration guide.
Custom snippets are still in the LanguagePack snippet set after the migration
If you migrated with Language Pack 5.78.0 or earlier, your custom snippets can remain in the LanguagePack snippet set next to the new BASE snippet set. Update the Language Pack plugin to 5.79.0 or later. The update moves these snippets to the BASE snippet set of their language.