Migration process - Shopware 5
Prepare Migration
Extension installation
After you have successfully installed Shopware 6 on your server, you can begin migrating your Shopware 5 shop. For this, you need the Migration Assistant extension for Shopware 6, which you can get from the Community Store.
It is also necessary to install the extension Migration Assistant in your Shopware 5 Shop from which you want to migrate.
The following description of the migration process refers to the migration assistant from version 16.0.0 of the extension.
Creating a connection
In order to migrate your data from Showare 5 to your Shopware 6 shop, you must first create a connection to your existing Shopware 5 shop. You start this in the Shopware 6 administration under the menu item Settings > Extensions > Migration.
As long as this connection to your Shopware 5 Shop exists, you can migrate data from the Shopware 5 Shop at any time.
Follow the instructions for creating the migration connection in this Docs article: Create a migration connection
Please do not use hyphens in the connection name. The free text fields from Shopware 5 are transferred to Shopware 6 as custom fields with the connection name. If a hyphen is present, this ensures that the custom fields are no longer displayed correctly in the storefront.
Edit connection
Depending on the interface you chose in the last step, you will now receive one of the following two queries.
API:
API-Key: Here you enter the API key of your Shopware 5 user. If none has been created yet, you can do this in the user administration of Shopware 5.
Username: Enter the username of your Shopware 5 administrator here. This must be the user for whom the above API key was assigned. It is important that this user must be in the "local_admins" group.
Shopdomain: Enter the domain of your main shop here. Be sure to indicate whether the shop uses a secure SSL connection.
Local:
DB-Host: Enter the Host URL of your database here. If the database is installed on the same server, you can also enter localhost here.
DB-Port: Enter the default port of your database here. Usually, this is 3306 by default.
DB-User: Specify a database user with administrative rights here.
DB-Password: Enter a database user with administration rights here.
DB-Name: Here you enter the database name of the database which contains the data of your Shopware 5 installation.
Installation Root: Enter the absolute path to the directory where Shopware 5 was installed.
Modify Metadata
As part of the migration, some metadata will be truncated as the database type will change from mediumtext to varchar(255). These values will therefore be truncated after 255 characters.
The following values are affected:
| table | column |
| s_article | description |
| s_categories | metadescription metakeywords |
Control your 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, can choose which data will be migrated and track your previous migrations.
Follow the instructions for checking the migration data and then performing the migration in this Docs article: Check migration data