Update Guide Shopware 5.2 to Shopware 5.3

Before updating

Same procedure as every update: update your installed plugins and make a backup of your environment! Make yourself familiar with the most important changes and the area of "What will break", so you can delete deprecated stuff and directly use new functions

Plugin compatibility - IMPORTANT

Before updating, take care that all of your installed plugins are up-to-date and compatible with the new Shopware version, otherwise your shop have problems at updating and you have to recover it from your backup. Whether or not your plugins are compatible can be checked in our Community Store or in your Shopware Account at Licenses.

Attention! All of your installed plugins had to be up-to-date and must be compatible to the actual version of shopware 5.3! Whether the plugins were active or not!

Note about the Shopware Premium-Plugins CustomProductsV2, Shopping Advisor and Einkaufswelten Advanced

The Premium-Plugins CustomProductsV2 (1), Shopping Advisor (2) and Einkaufswelten Advanced (3) will be marked by the Autoupdater as „not compatible“.

You can update in spite of the warning, but you have to update these plugins immediately after the updating to SW5.3.

These 3 plugins had no version that is compatible with SW5.3 and SW5.2 or SW5.1 either. You have to update these 3 premium plugins under SW5.2/1 to the current versions, so that no update is offered in plugin-manager. Afterwards you can ignore the compatibility notes on these plugins given by the autoupdater.

Achtung! This note applies exclusively to these 3 premium plugins. Other plugins, which are not compatible with SW5.3, had to be completely deleted before running the update.

Important changes

Partial-SSL-Mode deprecated

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 removed in Shopware 5.4.0, so in 5.4.0 SSL can only set globally. At updating with activated parial SSL mode you will be migrated to the global SSL mode, which means, that all URLs will be encrypted using https.

Caution! 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 not yet done, we recommend to do this change now! One the one hand this change can improve your Google ranking and secondly such a big change needs time, so take your time and start updating now and take a look in our wiki article how to forward the traffic to https.

Shopware Login Token

The Shopware Login Token, called SLT, is a cookie which makes recognition of your customers possible and is required for using Customer Streams and the "My Account"-Menu. Updating your shop, this function is disabled by default. More informations you can find in the article Shopware Login Token.

Customer Streams

With Customer Streams it's possible to group customers by inidvidual filters like the Product Streams. You can use these groups to display them deviant content like shopping worlds, vouchers, newsletter or promotions. More informations can be found here.

My Account menu

The My Account menu will automatically activate by activating the SLT cookie. When this function is active, your customers will be greeted by name and clicking the My Account button will open the account menu. By clicking a menu item, the customer must sign in, before he will see his account details. For more Informations, take a look at the article Shopware Login Token above.

Shopping world presets

With Shopware 5.3 it's possible to save existing shopping worlds as presets and export shopping worlds to import them in other shops. More informations will be linked here soon.

New filters

In Shopware 5.3 you can add your own listing filters, hereby you can choose from many possibilities, more informations can be found in the article Individual filter & sortings.

Buy from the listing / QuickView

From now it's possible to buy items directly from the listing or the QuickView, how it works, will be described here.

Cookie notice in the core

Shopware now provides a cookie notice in the core product, which will integrate perfectly in the responsive theme. Updating your shop, this function is disabled in order to not disturb your current solution. The Cookie Permission Pluign is not SW5.3 compatible had to be completly removed via the Pluing-Manager before updating to SW5.3.

The new cookie alert functin can be activated in the backend at Configuration > Basic Settings > Frontend > Cookie hint.

Load JavaScript asynchronously

In order to continuos performance improvements JavaScript now can be loaded asynchronously, this will be described in detail soon.

Plugin Safe mode

The new Safe mode deactivates all plugins, which are not made by Shopware, which helps you debugging at problems. How it works will be linked here

VARCHAR Attributes change to TEXT

All your VARCHAR fields in the attributes will change to TEXT due to the length limitation of VARCHAR. At changing the type your default values get lost because TEXT don't use default values.

Further news

  • Media exchange: In the media mananger media can now be exchanged: See here for details.
  • Shopping world performance: Shopping worlds will now be collected in less database queries and will be delivered to the frontend at once.
  • Shopping world preview: The preview of shopping worlds is now a real preview, it will not be saved anymore.
  • Delete orphaned thumbnails: Using the shell command sw:thumbnail:cleanup will check the whole shopware filesystem for orphaned thumbnails and delete them.
  • CAPTCHA refactoring: The Captcha methods were expanded and can now also be used at the registration and the newsletter subscription. Check here for further information.
  • Attribute types varchar will change: Yet in VARCHAR saved attributes will now be changed to TEXT to remove the existing restrictions.
  • Signing the cart: To protect the cart from manipulation it will be signed.
  • Item reviews: Item reviews now can be restrict to it's shop, so you can use a strict seperation of them if you want to.
  • Infinite scrolling on search result listing: Inifinte scrolling now is available for the search result listing.
  • Multiple item slider in shopping worlds: If multiple item sliders are used in a shopping world, they now will show different items instead of the same items.
  • Media manager: The media manager now saves the display settings for each user permanently.
  • Free text field management: Labels, help- and support texts are now translatable for different backend languages.
  • Library updates: The following libraries were updated: jQuery, Grunt, grunt-contrib-clean, grunt-contrib-copy, FPDF, FPDI

What will break?

  • Removed old Import/Export module: The discontinued import/export module is now removed and will be replaced by the former Import/Export Advanced module.
  • Own shipping cost calculation: If you use own shipping cost calculation, you may adjust it: "userID" is replaced by "user_id", "countryID" is replaced by "country_id" and "stateID" is replaced by "state_id".
  • Delivery tracking: Inside Smarty executable code now is blocked, so you have to link your tracking codes without code execution: https://gls-group.eu/DE/de/paketverfolgung?match={$offerPosition.trackingcode}.
  • SEO: _escaped_fragment_ was removed from the shoppwing worlds.
  • Deprecations: The old datenbase tables s_user_billingaddress, s_user_shippingaddress and s_core_engine_elements now are deprecated.
  • Browser compatibility: Internet Explorer < 11 is not supported anymore. Every styling is removed.

After updating

Update the version number of your used shopware version in your shopware account so that we can offer you the correct plugins: https://account.shopware.com/#/shops

After updateing, check your Plugin Manager for plugin updates, because now you have a new Shopware version and the Plugin manager may offer further updates. Only with the newest updates the updated shop will work correctly.

Informations for developers

If you are a developer you can take a look at our developer upgrade guide at: Shopware Developers - Upgrade Guide.


I always get an Error 500 - what can I do?

This error message is very generic and doesn't tell you anything about the actual problem; it just says that something has gone wrong. To detect the underlying problem, try to get more information by following the steps described here.

I see the following error message: PHP Fatal error: Uncaught exception 'SmartyCompilerException' with message 'Syntax Error in template "/home/xxx/www.xxx.de/themes/Frontend/xxx/frontend/index/index.tpl" on line 9 ""; unknown tag "s"

This message is often caused by a plugin that is incompatible with 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. Additionally, deactivate one plugin after the other in order to find the one that causes this behavior. To prevent errors like this from happening, please ensure that all installed Plugins have been marked as compatible in the Community Store.

I see the following error message: There is no suitable CSPRNG installed on your system

We updated some external code libraries that Shopware depends upon.

One of them is a compatibility library that allows use of PHP7+ functionality with PHP5. One change in this library is responsible for this error that should only affect a very small amount of systems out there.

If you are among the affected users, try the following:

  • Update your system to PHP7+
  • Allow PHP access to /dev/urandom

More information about the error can be found here. If you have further questions, your hosting provider will surely be able to assist you.

Some banners are missing from my shopping worlds after updating

To optimize the performance and network footprint of shopping worlds, banners are displayed using thumbnails with the correct dimensions for the user's device. For this to work though, thumbnails need to be generated 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 as described here. You may need to re-generate thumbnails after configuring the thumbnail sizes.

Suggested Items

Updating Shopware

Creating a backup Before updating Shopware, '''create a backup'''. Only with backups you can rollback easily if needed. Plugin compatibility - IMPORTANT Before updating, take care that all of your installed plugins are up-to-date and...

read more

First Run Wizard

Introduction The First Run Wizard will guide you through the setup of Shopware, where basic settings will be adapted. The First Run Wizard will only executed at the first login of an admin user after installing Shopware. After updates, the...

read more

System Requirements

'''Recommendation:''' You can find an overview of Shopware Hosting Partners '''here.''' If you are not sure, which hosting to get, take a look in the article '''"Which hosting should I use?"''' Server The required server...

read more
$ 13,62

Prices incl. legal
VAT + Shipping rates & policies*