Migration Shopware 5 to 6 (SaaS)

If you already have an existing Shopware 5 shop, you have the option of migrating it to the SaaS version of Shopware 6.
The migration process is relatively similar to the self-hosted migration. However, there are some slight differences. In this tutorial, we will show you how to perform the migration to the SaaS version successfully.

Step 1: Create a new SaaS Shop

Now go to the Merchant Area area in your shop account that you are already familiar with. There you can now create a new shop. Select the option "Create New Shop".

In the next step, you can start the administration of your new SaaS shop (1). The new SaaS shop is already configured in the background, so you don't have to do anything here at this point. As soon as the creation has been successfully completed, you can set the default language and the default currency. Your SaaS shop is now complete, and you can log into the administration with your Shopware ID.

Step 2: Launch Migration Assistant

To prepare and start the migration, you need the Migration Assistant extension. This is already installed automatically after the creation of the SaaS Shop. You can open the migration assistant via the dashboard.

Step 3: Create a new connection

Connection name (1): Enter a name for the migration here.
Shop system profile (2): Select the profile that corresponds to the version of your Shopware shop.
Gateway (3): Enter the connection type API here.

Step 4: Edit connection

This window is particularly important because the connection data to the Shopware 5 shop is entered here.
API key (1): You can find the API key in the Shopware 5 backend in the user management.
API-User (2): Enter the username of your Shopware 5 backend here.
Shop domain (3): Enter the domain of your Shopware 5 shop here.

Step 5: Start Migration 

If you have entered the correct (API) connection data, the status message Connected (1) appears in the migration assistant. You can now start the migration.

After you have entered all the necessary details of your connection, you will be redirected to the migration overview. Here you have an overview of the current connection, as well as the option to choose which data will be migrated and to track your previous migrations.

General

After you have successfully established the connection, you will automatically be taken to the migration overview. Here you can see to which shop system (1) you have currently established a connection. You can also see which system profile and which gateway was used for the connection, when the last connection check was carried out and when the last migration was carried out with this connection. You can make changes to the current connection via the Edit connection button (2).
Via the dropdown menu (3) you can create a new connection, delete the access data of the current connection or switch to another created connection. You can also reset checksums via this dropdown menu. 

Data Selection

In the data selection, you decide which data you want to migrate into the Shopware 6 shop using your connection. To do this, simply select the corresponding data that is to be migrated. The list also shows you whether it is shop data or extension data and how many data records will be migrated.

Extensions: Data that can be migrated from third-party extensions is shown in this list with the type Plugin data.
In some cases, third-party providers also offer their own migration profile for their extension data, which must then be used for migration. In this case, you will receive all migration information from the relevant provider.

Summary

In the summary, you have the option of viewing all previous migrations and migration attempts. All information about the migrations is displayed.

Complete Migration 

During the migration process, it is important that the tab in which the migration was started remains open until the migration is completed, otherwise, the migration may be aborted. 


After you have clicked on Start migration, the migration is carried out in four steps. Data check, reading the data, writing the data and Media Download. 

Data check

The migration now carries out a data check. This checks whether data from the old shop can be assigned to the new one.

Manual assignment:

If data, such as the default payment type, could not be correctly assigned, it is necessary to assign it manually. As soon as you have manually assigned all unassigned data, you can continue the migration by clicking the Continue button. If all data was assigned without problems, manual assignment is no longer necessary. In this case, you can continue the migration.

Processed Assignments

In the assignments that have already been made, you can check whether the automatically assigned data have been matched correctly. Here you can also change your assignments later or change the automatic assignments afterwards. 

If you have a particularly large Shopware 5 installation, you can also carry out the migration at this point via the console (CLI). To do this, cancel the process after the data check and continue the migration here.

Reading the Data

In this step, all data to be migrated is read from the source shop. 
All data that is read is given a checksum that is used during subsequent migrations to check whether the data has already been migrated. All unchanged data is therefore not migrated again. 

If data is not migrated even though it has changed, the checksums can be reset. You can find out more about this in the section Performing migration again.

Writing the Data

The read data is now written to Shopware 6. Customer groups, categories, languages, currencies and sales channels are automatically created in Shopware 6 in this step, if they do not already exist.

Media Download

In this step, all media files from the old Shopware 5 installation are downloaded and loaded into the Shopware 6 media management.

Was this article helpful?