Migration - Upgrade Guide Shopware 6


6.0.0 or newer

Table of contents

After you have executed the migration and the data selected in the migration plugin has already been transferred, there are still a few points where a manual check and maybe adjustments are necessary.


For which data is a manual check necessary? 

Sales channel

The sales channels represent the basic interfaces to other program areas such as the shop front end. Since this function did not exist in Shopware 5, the data cannot be transferred from your previous shop, so please check the settings of the individual sales channels and create additional channels if necessary.
You can find information on this in the documentation under Sales channel.


Since some technical changes have been made in the background for the shipping costs in Shopware 6, it is not possible to transfer the data automatically. Among other things, the extensive functions of the Rule Builder are now available to you and can be used accordingly in the shipping costs.
Therefore, it is necessary that you create the shipping costs again.
You can find the shipping costs module under Settings > Shop > Shipping
Detailed information about the new shipping module can be found in the article shipping.


Payment methods
Similar to the shipping costs, some changes have also been made to the payment methods, which prevent automated data transfer. Risk management, for example, is now directly integrated into the payment types via the Rule Builder.
Please check the existing data under Settings > Shop > Payment methods and add any payment options that are not yet available.
In the article Payment methods you get all relevant information to manage and create the payment methods in Shopware 6.

Additionally check under Settings > Shop > Countries whether all countries relevant for you are present and active.
You can use the documentation under Countries to find out how to add new countries and adapt existing ones. 

The document templates were also redesigned.
You can add your data for the header, account data, etc. to these under Settings > Shop > Documents.
Additional information can be found in the article Documents

Email template
Shopware 6 uses "Twig" as template engine, so it is not possible to use the previous email templates. You can access the module via Settings > Shop > EMail Templates.
Under Email templates you will find the necessary information to customize your templates.
It also contains information about the new variable format.

Shopping worlds / Shop pages

The shopping worlds and shop pages known from Shopware 5 are bundled centrally in Shopware 6 under the new Shopping Experiences. As this is based on a different technical structure, it is currently not possible to transfer the data.
Please adapt the shop pages and landing pages according to your needs or create new ones, you will find the module under Content > Shopping Experiences.


With Shopware 6, the basic architecture has been completely redesigned and in this context, Shopware also relies on new technologies. For this reason, it is not possible to reuse your old templates or migrate them to Shopware 6.
Shopware 6 comes with its own template so that you can get started directly with Shopware 6.

If you want to use your own individual theme, you can use the included template as a basis.
You can find out how to adapt the template accordingly in our developer documentation.

Further information

After the migration, we generally recommend that you compare the individual functions of your new Shopware 6 instance with those of Shopware 5 by calling up the individual functions in both systems, such as the article detail page or completing an order.

previous step    next step


Was this article helpful?