We must have heard the word “migration,” which undoubtedly means relocating a person or a species from one place to another. But in the web or software technology, migration is something else, it is a new beginning. It also means that in this new journey you have to come with better efforts and planning. There will be many things on which you have to focus and plan how the migration process should carry out. Whatever steps or consultants you require, in this article, we will give you all the relevant information on how to migrate your Shopware 5 ecommerce store to the Shopware 6 version.

Migration Phases

There are three different phases in the migration process. You have to follow each step efficiently and achieve the goal step by step to migrate to Shopware 6 successfully. Let’s know about all these phases:

Preparation Phase

The Preparation Phase is constituted of the information part. We will give you all the knowledge that you must know for a successful migration or estimate how a migration comes into question for you.

Plugin Installation

Firstly you have to install the Shopware latest version i.e. Shopware 6 on your server, and now you can begin the migration process. You will require a Migration Plugin for the migration process for Shopware 6, which you can quickly get from the Plugin Store. You have to also install the plugin ShopwareMigration in your Shopware 5 store that you want to migrate.

Creating a Connection

To migrate the data from Shopware 5 to Shopware 6, you have to connect to your existing Shopware 5 shop. You can start this in the Shopware 6 administration in the menu item Settings -> Migration. Till this connection exists, you will be able to migrate the data from the Shopware 5 store.Creating a Connection

Click on Create Connection for creating a new connection.Create Connection

In the Name section, you have to enter a unique name for making the connection. It is highly required, especially if you want to build a connection for multiple Shopware 5 stores.

In the Profile, mention the source system type. In the standard system, select Shopware55 for the migration process. However, third-party providers can also work with the other profiles.

The Gateway indicates the type of connection between the two systems. Here you choose API if you want to migrate a remote shop or Local if the shop is located on the same server.

Edit Connection

On the type of interface you have chosen in the last step, you will receive one of the following two queries:

Edit Connection
In the API section, enter the API key of the Shopware 5 user. If you haven’t created any yet, you can create them in the user admin of Shopware 5.

Username: Enter the Shopware 5 admin username here. It must be that user for whom you assign the above API key.
Shop domain: Enter the main shop domain here. Also, indicate whether the shop is using a  secure SSL connection.

establish a connection
Enter the host URL of the database in the DB-Host field. If the database is on the same server, enter the localhost here.

Now, enter the default port of the database in DB-Port. This is generally 3306 by default.

Enter a database user with administration rights in the DB-User and enter its password in the DB-Password. In the DB-Name, enter the database name, which contains the data of your Shopware 5 installation. Enter the absolute path to the directory where Shopware 5 was installed in the Installation Root section.

Modify MetaData

The metadata will be truncated in the migration process as the database type changes from medium text to varchar(255). Thus, the values will get truncated after 255 characters. These values will get affected:

table column
s_article description
s_categories Meta description
Meta keywords

Migration Period

After entering all the necessary connection details, you will be navigated to the migration overview. You will get an overview of the current connection, and you can track which data should be migrated.


Migration PeriodAfter making the connection successfully, you will be automatically navigated to the overview of the migration. Firstly you can check with which shop, i.e., the System you are currently connected to. You can see which system profile & interface has been used and when the last connection or last migration was carried out using this connection.

In the Edit Connection button, you can make specific changes to the current connection. On clicking the dropdown button, you will file multiple options of creating a new connection, delete the existing connection, or switch to another connection. You can also use this drop-down for resetting the checksums.

Data Selection

data selectionIn this section, you will decide which data you should migrate from your existing Shopware shop to the Shopware 6 version. For doing this, you have to check the corresponding data you want to migrate. You can also find whether it is shop data or plug-in data in the list and how many data sets have been migrated.


In the History tab, you can view all previous migrations or their attempts. You will get all information about the migrations.

Start Migration

After clicking on Start migration, there are four steps to perform the whole migration process. These are Data Check, data reading, and media download.

Data Check

There will be a data check in the migration process. It will check whether the old shop will be assigned to the new shop.

Manual Assignments

manual assignmentsIf data like standard payment type hasn’t been assigned correctly, you must manually assign it. After manually assigning the data, you can continue the migration by clicking on the Continue button. If the data is being migrated without any issue, then the manual assignment isn’t even necessary. In this case, you can continue the migration immediately.

Processed Assignments

Processed AssignmentsIn the processed assignment, you can find whether the automatically assigned data has been appropriately assigned or not. Also, you can change the allocations later or change the automatic allocations later.

Data Reading

Data ReadingIn data reading, the data which you need to migrate from the source will be read. You can also change the assignments later or change the automatic assignments later.

Data Writing

Data WritingThe read data will be written in Shopware 6.

Media Download

Data DownloadLast but not least, the media files of your existing Shopware store will be downloaded and loaded into the media management of your new Shopware 6 store.

Also Read: eCommerce Replatforming & Website Migration: Complete Guide

Wrapping Up

In this article, we have understood the whole process of migrating your existing Shopware 5 store to the latest version of Shopware 6. We at Emizentech, the best Shopware development company in India, have expert Shopware developers who will not just upgrade your Shopware store to the latest version but can do completely fix any arising bugs or issues. Let us know your requirements.

Avatar photo

Founder and tech lead at Emizentech, Mr. Vivek has over ten years of experience in developing IT infrastructures and solutions. With his profound knowledge in eCommerce technologies like Shopware, Magento, and Shopify, Mr. Vivek has been assisting SMEs to enterprises across the globe by developing and maintaining their eCommerce applications. Technology innovation and trends insight come easy to Vivek with his thorough knowledge in the eCommerce domain. See him talking about ideas, trends, and technology in this blog. To know more about how Team Vivek can assist you in your eCommerce strategy? Connect team Vivek here.