Migration Assistant

Migration Assistant

by shopware AG


Official Shopware Migration Assistant. Helps migrate data from supported source systems to Shopware 6 through a guided migration process.

This plugin is compatible with the following Shopware 6 versions:

6.7 6.6
  • Future updates
  • MIT license

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

Source: Github Repository


Changelogs

  • #18902 - Fixed a bug in media migration whereby failed downloads were not marked as definitively failed once the retry attempts had been exhausted. As a result, processing could not be completed correctly.
  • #17832 - Fixed attribute migration so custom fields with an empty label no longer abort the run. The reader now keeps the column_name in the attribute configuration.
  • #12748 - Fixed order migration so product.sales is recalculated from persisted order line items after migrated orders are written. Cancelled orders are excluded from the sales calculation.
  • Fixed attribute migration on installations that resolve Doctrine DBAL 4.2, where reading attributes through the Shopware local gateway aborted the run.
  • Migration connection credentials are no longer exposed in Admin API entity responses and can now be retrieved through a dedicated endpoint with editor permissions.

  • 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


  • Fixed Shopware 5 customer migration with custom locales by resolving languageId from existing migration mappings during the same run

  • #15568 - Switched to PHP Symfony service definitions
  • Fixed a migration issue where malformed relation records with missing root IDs could abort the run during cleanup and leave it stuck

  • #15318 - Fixed missing cleanup of the swag_migration_fix table when truncating a migration
  • #15637 - Fixed connection fingerprint compatibility with <6.7.2.0

  • Fixed log entries to have the file path and line number in the exception message
  • Remove support for Magento 1.9
  • Reduced log file size by removing exception trace args

  • #14517 - Fixed duplicate key error when re-migrating products with SEO main categories after checksum reset
  • #14400 - Removed the "Delete migration data" action from the migration history context menu
  • #13898 - Fixed migration of orders with different tax rates on line items from SW5
  • #11808 - Introduced Error Resolution to manage data inconsistencies and apply migration fixes directly in the SW6 administration, instead of fixing issues in the source system as it was needed previously.
  • #11808 - Enriched migration logs with detailed data descriptions to improve error traceability.
  • #11808 - Integrated ACL constraints to restrict specific migration actions based on user permissions.
  • #11808 - Improved data reliability via stronger validation checks for converted data.
  • #11808 - Applied general UI/UX improvements for visual consistency.
  • #11808 - Removed CLI commands migration:abort, migration:get-progress, and migration:start. You have to start the migration via the Administration UI, it still runs in the background message queue
  • #11808 - Checksum reset and migration data cleanup now run asynchronously via message queue.

  • Added shopIdV2 to the list of ignored system config entries for Shopware 6 connections
  • Media processing has been simplified so that the UI can show the actual progress

  • Fixed translations of error groups missing details like the entity
  • Fixed handling of customers without default payment method in SW6.7 migrations

  • Fixed data selection tab freezing due to infinite loop in SW6.7RC4 or later
  • Fixed connections names containing hyphens causing errors for custom field migration
  • Fixed premapping for administration users if username is empty

  • Fixed deprecation warnings for tagged argument in services definitions

  • 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)