Same procedure as every update: update your installed plugins and make a backup of your environment! Familiarise yourself with the most important changes and the section "What will break". This way you can delete deprecated stuff and directly use new functions.
Before updating, make sure that all of your installed plugins are up-to-date and compatible with the new Shopware version. Otherwise your shop may encounter problems during the update and you might have to recover it from your backup. Whether your plugins are compatible or not can be checked in our Community Store or in your Shopware Account in the Licenses section.
All of your installed plugins have to be up-to-date and must be compatible with the actual version of Shopware 5.3! This rule applies regardless whether plugins are active or not!
The Premium-Plugins CustomProductsV2 (1), Shopping Advisor (2) and Einkaufswelten Advanced (3) will be marked by the Autoupdater as „not compatible“.
You can however safely update in spite of the warning. But you will have to update the plugins immediately after the update to SW5.3.
These three plugins are not available in versions that are compatible with all three of the latest Shopware versions (SW5.3, SW5.2 and SW5.1) You have to update these three premium plugins in an instance of SW5.2/1 to the current versions. You were successful if no more updates are offered in the plugin-manager. After you have completed the procedure you can ignore the compatibility notes on plugins given by the autoupdater.
This note applies exclusively to these three premium plugins. Other plugins, which are not compatible with SW5.3, have to be completely removed before running the update.
The partial SSL mode (SSL active, but "use always SSL" deactivated), which encrypts only security relevant areas like the account and checkout, will be deprecated for now and are scheduled to be removed in Shopware 5.4.0. So in Shopware 5.4.0 SSL can only be set globally. After updating with activated partial SSL mode you will be migrated to the global SSL mode, which means, that all URLs will be encrypted using https.
Google will rate this change as a complete new URL, so Google will remove your existing URLs from the index! So make sure, that you forward your old unencrypted URLs to the new encrypted ones using 301! If you need help, please contact your SEO agency.
If you haven't already, we recommend you carry out these changes now! Firstly the Update might improve your Google ranking and secondly prepare for big changes to take their time. So you should take your time, too and start updating now to have a look at our wiki article on how to forward traffic to https.
The Shopware Login Token (SLT) is a cookie which enables you to recognise your customers and is required for using customer streams and the "My Account"-Menu. After updating your shop, this function is disabled by default. You can find even more information in the specific SLT article Shopware Login Token.
With customer streams it is possible to cluster customers utilizing individual filters, just like it is possible via the above mentioned product streams. You can use these groups of customers to display deviant and personalised content like shopping worlds, vouchers, newsletter or promotions. Find more information here.
The My Account menu will be automatically activated alongside of the SLT cookie. When this function is active, your customers will be greeted by their names and clicking the My Account button will open the account menu. Clicking any menu item, prompts the customer to sign into the service in order to access his account details. For more information, take a look at the article Shopware Login Token above.
With Shopware 5.3 it is possible to save existing shopping worlds as presets. This enables you to export your shopping worlds into other shops. More information on this will be available here soon.
In Shopware 5.3 you can add your own listing filters, opening up numerous possibilities. More information can be found at Individual filter & sortings.
From now on it is possible to buy items directly from the listing or the QuickView. How that works, will be described here.
Shopware now provides a cookie notice in the core product, which will integrate perfectly into the responsive theme. Right after updating your shop, this function is disabled in order to help you keep your current solution running. The cookie permission plugin is not compatible to SW5.3 and has to be removed completely via the Plugin-Manager before updating to SW5.3.
The new cookie alert function can be activated in the backend at Configuration > Basic Settings > Frontend > Cookie hint.
The new safe mode deactivates all third party plugins. This should help with debugging and getting a grip on any kind of problems you might encounter. Read further: here
All your text boxes formatted in VARCHAR will be changed to the TEXT format due to the maximum string length of 255 characters which might cause problems in the future. Note that TEXT fields do not support default values by design. If you have set any VARCHAR default values, these will be lost.
Adjust the version number of your current shopware iteration in your shopware account so that we are able to offer the correct plugins to you.
After updating, check your plugin manager for plugin updates. Now that you have a new Shopware version the plugin manager may present you with such. The updated shop will most likely not work correctly if you did not update your plugins accordingly.
If you are a developer you can take a look at our developer upgrade guide at: Shopware Developers - Upgrade Guide.
This error message is very generic and doesn't tell you anything about the actual problem at hand; What you can take away from it is, that something has gone wrong. To identify the underlying problem, try and gather more information by following the steps described here.
This error message is often caused by an incompatible plugin in Shopware 5.3 or a template modification that is incompatible with the smarty security mode we introduced in Shopware 5.3. Try to gather more information by following the steps described here. If the above mentioned methods fail, try and deactivate one plugin after the other in order to find the one that caused the errror. To prevent errors like this from happening, please ensure that all installed plugins have been marked as compatible in the community store.
We updated some external code libraries that our software depends upon in the deployment of Shopware 5.3. One of those is a compatibility library that allows the use of PHP7+ functionalities with PHP5. Although the alteration in that library only affects a small number of systems negatively, it is most likely responsible for this error.
If you are among the affected users, try the following:
More information about the error can be found here. If you have further questions, your hosting provider will surely be able to assist you.
To optimize the performance and network footprint of shopping worlds, banners are displayed using thumbnails that fit the correct dimensions of the user's device. For this to work though, thumbnails need to be generated and available first.
This functionality is normally handled automatically by Shopware, but if you are affected by this error, you might want to check if the correct thumbnail sizes have been set in the media manager. You may need to generate thumbnails anew after configuring the thumbnail sizes.