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.
Note: For information on how to update ThemeWare®, see the article Updating ThemeWare®.
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)
z.B. 6.5 > 6.6
Minor-Release
Functionality is added in a backward-compatible manner
z.B. 6.5.1 > 6.5.2
Patch-Release
Backward-compatible bug fixes are made
z.B. 6.5.1.1 > 6.5.1.2
Compatibility
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.
Major-Releases
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.
Note: More information about the topic "ThemeWare®/Shopware Compatibility" you will find in our article Shopware Compatibility.
Important: Please always use the update option of the extension management and do not install extensions manually to avoid installing an incompatible extension.
Shopware Update
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.
Note: "Deactivating" extensions (plugins, apps or themes) does not delete any data.(Status: Shopware 6.4.18.0)
Tip: Most of this guide applies to all extensions (plugins, apps or themes), but to simplify matters we refer to ThemeWare®.
Step-by-step 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 (A).
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 (B).
If the current version of ThemeWare® is not compatible with the new Shopware version but there is a compatible ThemeWare® version for the new Shopware version, deactivate ThemeWare®, update Shopware first and then ThemeWare® (C).
If the current version of ThemeWare® is not compatible with the new Shopware version and there is currently no compatible ThemeWare® version, deactivate ThemeWare®, perform the Shopware update and reactivate ThemeWare® only after you have been able to update it (D).
These three cases are considered in the following instructions:
1) Preparation
Before you start a Shopware update, please update ThemeWare® and all extensions (plugins or apps) in your system to the latest versions.
Check if there is already a compatible version for all extensions.
Tip: If you want to make sure that ThemeWare® is already compatible, you can check the store page of the corresponding extension in the Shopware Community-Store which versions are currently supported.
To be on the safe side, make a full backup of your system before updating Shopware.
Then deactivate all incompatible extensions or themes.
Important: Update all extensions (plugins, apps or themes) in your system before every Shopware update.
Important: Deactivate all incompatible extensions before a Shopware update and activate them if you have been able to update them to a compatible version.
2) Shopware Update
There are three options for Shopware updates:
A. Already compatible
ThemeWare® is already compatible with both the current and the new Shopware version:
Optional:Assign the "Shopware default theme" to your sales channel
Optional: Then deactivate your ThemeWare® theme
Optional: Execute a ThemeWare® update
Execute the Shopware Update
Important: Only if really all extensions are "already compatible"!
Optional: Activate ThemeWare® again
Optional: Assign ThemeWare® to your sales channel to complete the process
Note: If you were unable to update ThemeWare® to the latest version, take a look at the articleThemeWare® update not available.
B. Now avaiable
A compatible ThemeWare® version is available before the Shopware update:
Assign the "Shopware default theme" to your sales channel
Then deactivate your ThemeWare® theme
Execute the ThemeWare® update
ThemeWare® now is "already compartible" (A)
Now execute the Shopware update
Important: Only if really all extensions are "already compatible"!
Activate ThemeWare® again
Assign ThemeWare® to your sales channel to complete the process
Note: If you were unable to update ThemeWare® to the latest version, take a look at the articleThemeWare® update not available.
C. With new Shopware version
A compatible ThemeWare® version is available after the Shopware update:
Assign the "Shopware default theme" to your sales channel
Then deactivate your ThemeWare® theme
Execute the Shopware update
Now execute the ThemeWare® update
Important: Make sure that your ThemeWare® version is compatible with the current Shopware version: Shopware Compatibility
Activate ThemeWare® again
Assign ThemeWare® to your sales channel to complete the process
Note: If you were unable to update ThemeWare® to the latest version, take a look at the articleThemeWare® update not available.
D. Not compatible
A compatible ThemeWare® version for the new Shopware version is NOT yet available:
If there is no compatible version of ThemeWare® yet for the new release, wait with the Shopware update until this is the case.
If you still want to perform the Shopware update, leave ThemeWare® (any incompatible extension) deactivated until you have been able to update to a compatible version.
Good to know 💡
Make a backup before every Shopware update!
Have you missed any release news? Get informed about past releases.
You can also find all the new features in the changelog.
Don't forget to give us feedback.
Further information
Tip: You can find information concerning updates and changes in the ThemeWare® Update-Newsletter, in the ThemeWare® Changelog in our Service Portal or in the Shopware Store. Please find all links in the article Updates and news.
Last updated
