Migration - Upgrade Guide Shopware 6

After you have executed the migration and the data selected in the migration extension 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 frontend. Shops and subshops from your Shopware 5 Shop are created as sales channels.
You can find information on this in the documentation under Sales channel.

The migration creates each main and subshop as its own sales channel in Shopware 6. However, when Shopware 6 is installed, two sales channels are already created in the standard system. 
If you do not see the migrated data in the frontend, the previously installed sales channel is opened via the standard domain. 
To see the migrated data in the frontend, it is necessary to adjust the domain settings of the additionally created sales channels.


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.


Was this article helpful?