SwagMigrationAssistant

Migration Assistant

by shopware AG



The Shopware Migration Assistant is the official open-source extension developed by Shopware. It helps migrate data from supported source systems to Shopware 6 by guiding users through the migration process step by step.

The extension supports the migration of various data types, including products, manufacturers, customers, and additional business data. Before importing, the Migration Assistant analyzes the source data and assists with mapping records that cannot be assigned automatically, helping reduce the risk of data loss during migration.

Key Features at a Glance

  • Guided migration process for Shopware 6.
  • Supports multiple source systems through dedicated migration profiles.
  • Migrates various data types, including products, manufacturers, and customers.
  • Validates source data before migration.
  • Assists with mapping data that cannot be assigned automatically.
  • Supports updating previously migrated data.
  • Compatible with the Shopware 5 Migration Connector for secure communication between Shopware 5 and Shopware 6.
  • Open-source extension for Shopware 6.

The Shopware Migration Assistant is ideal for merchants, agencies, and developers who want to migrate existing shop data to Shopware 6 in a structured and reliable way.

Open Source and License Notice

This plugin is based on the open-source project SwagMigrationAssistant by Shopware and is distributed through our platform. Unless stated otherwise, this plugin is provided under the terms of the MIT License. The original copyright notice and the full license text are included in the plugin package.

Copyright (c) shopware AG

The software is provided "as is", without warranty of any kind, to the extent permitted by applicable law. The terms of the MIT License shall prevail. You can find the full license text in the plugin package and at: https://github.com/shopware/SwagMigrationAssistant/blob/trunk/LICENSE


Changelogs

14.1.0
6th July 2026 (11 hours ago)
  • MIG-1082 - Fixes an error with repeated migration of customer wish lists from SW5 to SW6
  • MIG-1096 - Fix json_decode with null run exceptions that occurred with mappings of old migration runs (older assistant versions)


18.0.0
6th July 2026 (11 hours ago)
  • Fixed Shopware 6 sales channel migration so additional sales channels, such as Social Shopping, are now migrated correctly when their sales channel types already exist in the target shop before the migration starts
  • Sales channels with types that are not available in the target shop are now skipped instead of causing follow-up issues
  • Fixed Shopware 5 order migration so billing and shipping addresses are kept even when the salutation cannot be mapped during conversion


This plugin is compatible with the following Shopware 6 versions:

6.6 6.7
  • Future updates