Shopware Updates and ThemeWare®
In this guide you will learn how to proceed if you need to update Shopware 6 together with ThemeWare® update.
We regularly release updates of ThemeWare®. So most of the ThemeWare® updates you do independently from Shopware updates.
But of course there are also cases where you want to perform a Shopware update. In these cases, it always makes sense to update extensions (plugins, apps or themes) before or after.
Whether you need to update extensions before or after the Shopware update depends on the compatibility of the extensions (plugins, apps or themes).
The type of Shopware release must also be taken into account here, as there are different types of Shopware releases:
Shopware versioning
Major-Release
Incompatible API changes are made (= breaking changes)
Minor-Release
Functionality is added in a backward-compatible manner
Patch-Release
Backward-compatible bug fixes are made
Basically,ThemeWare® is always compatible with the latest Shopware version or will be released in a compatible version in the short term. Accordingly, there is always a suitable ThemeWare® version for older Shopware versions.
As we test ThemeWare® in every new Shopware release, it can happen – depending on how extensive the necessary adjustments are – that a ThemeWare® update is only released shortly after the Shopware update.
However, it can happen that there is no ThemeWare® version (this applies to all extensions) that is compatible with both the old and the new Shopware version at the same time. This is always the case when Shopware makes so-called "breaking changes" that make compatibility with both versions impossible.
As you can see in the "Shopware versioning" above, "breaking changes" are mainly possible in major releases.
The Shopware update wizard will inform you if there are incompatible extensions. Incompatible extensions must be deactivated before the Shopware update and should only be activated when a compatible version has been released.
Please find more information on the correct procedure in the following instructions.
Please find below a step-by-step guide for Shopware updates. Basically there are three possible cases:
If the current version of ThemeWare® is compatible with both the current and the new Shopware version, you can easily update Shopware ().
If the current version of ThemeWare® is not compatible with the new Shopware version but there is a compatible ThemeWare® version for the current and the new Shopware version, first update ThemeWare® before updating Shopware ().
If the current version of ThemeWare® is
These three cases are considered in the following instructions:
We recommend that you wait a few days/weeks before updating Shopware - especially for major releases of the update.
Test each update in advance in a test system or a staging environment and check that everything works smoothly.
It is also essential to create a complete backup of your shop before the Shopware update.
Update ThemeWare® and all extensions (plugins, apps or themes) in your system to the latest versions.
Check whether there is already a compatible version for all extensions (plugins, apps or themes) or themes.
It is best to only perform out the Shopware update if you have ensured that all extensions used are installed in a compatible and error-free version.
If you want to perform the Shopware update even if not all extensions used are compatible, leave incompatible extensions deactivated until you have been able to install a compatible version.
There are three options for Shopware updates:
Optional:Assign the "Shopware default theme" to your sales channel
Optional: Then deactivate your ThemeWare® theme
Tip: Clear the entire Shopware cache once
Assign the "Shopware default theme" to your sales channel
Then deactivate your ThemeWare® theme
Tip: Clear the entire Shopware cache once
Assign the "Shopware default theme" to your sales channel
Then deactivate your ThemeWare® theme
Clear the entire Shopware cache once
If there is no compatible version of ThemeWare® yet for the new Shopware release, wait with the Shopware update until this is the case.
If you still want to perform the Shopware update, leave ThemeWare® (or any incompatible extension) deactivated until you have been able to update to a compatible version.
This message is largely self-explanatory. The extension in question is not available in the Shopware Store and therefore cannot be updated automatically. In this case, please update it manually or deactivate it before updating Shopware until compatibility has been checked and confirmed.
We hope you have followed the hints regarding the creation of a backup and testing in a staging environment and you can restore your backup or perform a new test.
If this is not the case, deactivate the problematic extension and only activate it once you have been able to update the corresponding extension to a compatible version (see ).
If the administration is not accessible due to an incompatible extension, deactivate the corresponding extension via the database (see ). The administration should then work again.
Always refer to our update guide when updating ThemeWare®:
