The major update process from Shopware 4 to Shopware 5 is very simple and performed just like any other update from Shopware. Please note that this update will bring many changes to your system. For this reason, you should not perform the update directly on your live environment. First off, you should try installing this update on a test environment. We advise you to create a backup before, should you be running into any issues.
The system requirements for Shopware 5 have changed. From now on, PHP version 5.4 and MySQL version 5.5 are required. If you’re using a commercial Shopware version, you will need the Ioncube Loader version 4.6 or higher. We will change these requirements during future releases of Shopware 5. For this reason, we strongly recommend you to update to the most recent stable version of PHP, MySQL and Ioncube. For our new Responsive standard template, we discontinued the support for Internet Explorer < = 8. The old basic template continues to support Internet Explorer version 7 or higher.
We strongly recommend to use the AutoUpdate assistant to perform this update. This way, you can perform a system check beforehand. You will receive an update notification in the backend starting at version 4.3.5/4.3.6.
There are multiple ways to perform this Shopware update. You will find two possible ways in our Release article. You can perform this update starting at version 4.2.x
All installed Plugins must be compatible with Shopware 5. Never update with incompatible Shopware 5 plugins. If you have any of those installed (no matter if deactivated or not), you will have to completely uninstall them before performing the update. Otherwise you won’t be able to reach your Backend (respectively Plugin-Manager) anymore. In this case, you will have to overwrite your files with a previously generated backup and perform the update from scratch. You should check all plugins for their compatibility in our store.
If you want to upgrade to Shopware 5 and want to use the new template, you have to pay attention to a few details. For that reason, we recommend you using a test environment first.
New thumbnail sizes
The new responsive template utilizes new picture sizes in the frontend, to ensure that the picture is always being displayed in the right size. After switching to Shopware 5, you will have to change thumbnail sizes for the albums using the media manager in the backend. Please ensure that you delete the old sizes in this process. (right mouse button on thumbnail size)
|Shopping worlds||800x800, 1280x1280, 1920x1920|
|Banner||800x800, 1280x1280, 1920x1920|
|Items||200x200, 600x600, 1280x1280|
|Blog||200x200, 600x600, 1280x1280|
Afterwards you should generate new thumbnail sizes. You are able to perform this directly in the media manager. For larger amounts of data, we recommend to use the Shopware CLI tool command sw:thumbnail:generate.
After generating all thumbnails, check the following areas and if needed, change the used thumbnail size.
In Shopware 4, additional text on variants (e.g. XL, green) would always be and filled into it’s field while generating the variant. In Shopware 5, the field remains empty. For this case, Shopware generates additional texts automatically in the frontend while displaying the fitting language. To activate this new function on all items, you should empty the “additionaltext” field in your database. You can use the following SQL-Statement to perform this change:
UPDATE s_articles_details SET `additionaltext` = ''; UPDATE s_article_configurator_templates SET `additionaltext` = '';