PHPackages swag/migration-assistant - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. swag/migration-assistant ActiveShopware-platform-plugin[Utility & Helpers](/categories/utility) swag/migration-assistant ======================== Migration plugin for shopware/platform 16.1.1(2mo ago)2036.3k↓20.7%25[6 PRs](https://github.com/shopware/SwagMigrationAssistant/pulls)MITPHPCI passing Since May 20Pushed 1mo ago30 watchersCompare [ Source](https://github.com/shopware/SwagMigrationAssistant)[ Packagist](https://packagist.org/packages/swag/migration-assistant)[ RSS](/packages/swag-migration-assistant/feed)WikiDiscussions trunk Synced 1mo ago READMEChangelog (8)Dependencies (2)Versions (115)Used By (0) SwagMigrationAssistant ====================== [](#swagmigrationassistant) The Shopware Migration Assistant establishes a connection between a data source and Shopware 6 and guides you step by step through the migration process. It supports migrating numerous datasets (products, manufacturers, customers, …) and updating them at any time. Before a migration starts, the assistant runs a data check and supports creating “mappings” to resolve missing/unassignable data (for example: assign missing manufacturers to a default manufacturer) to avoid data loss. Overview -------- [](#overview) - [Documentation](#documentation) - [Shopware 5](#shopware-5-migration-connector) - [Requirements](#requirements) - [Installation](#installation-shopware-6-project) - [Developer setup](#developer-setup) - [Common workflows](#common-workflows) - [Release notes / upgrades](#release-notes--upgrades) - [License](#license) Documentation ------------- [](#documentation) - **User documentation**: [Shopware Migration docs](https://docs.shopware.com/en/migration-en) - **Developer documentation**: [Migration Assistant developer docs](https://developer.shopware.com/docs/products/extensions/migration-assistant/) Shopware 5: Migration Connector ------------------------------- [](#shopware-5-migration-connector) When migrating from Shopware 5, you can migrate locally or connect via the “Migration Connector” plugin from the Shopware Store: - **Migration Connector**: [Shopware Store listing](https://store.shopware.com/de/swag226607479310f/migration-connector.html) The connector provides API endpoints so Shopware 6 can establish a secure connection to the Shopware 5 shop. Keep it enabled as long as you need updates/delta migrations. Requirements ------------ [](#requirements) - **Shopware**: `shopware/core` (see version here [`composer.json`](composer.json)) - **Node.js / npm**: required for administration and JS tooling (lint/unit/acceptance) - **MySQL client**: required for importing Shopware 5 fixture data (optional) Installation (Shopware 6 project) --------------------------------- [](#installation-shopware-6-project) Expected path (relative to your Shopware 6 project root) for the plugin: `custom/plugins/SwagMigrationAssistant` From the shopware root directory: ``` bin/console plugin:refresh bin/console plugin:install -a -c SwagMigrationAssistant ``` Alternatively, use the provided shortcut: ``` composer setup ``` Developer setup --------------- [](#developer-setup) - **Install JS dependencies** (administration + Jest + Playwright project): ``` composer npm:init ``` - **Install git pre-commit hook** (optional): ``` ./bin/setup.sh ``` Common workflows ---------------- [](#common-workflows) ### Linting & formatting [](#linting--formatting) Run everything (PHP + admin): ``` composer lint ``` Run individual parts: ``` composer ecs composer phpstan composer phpunit composer admin:lint # eslint composer admin:format # prettier ``` ### Tests [](#tests) - **PHPUnit**: ``` composer phpunit ``` - **Administration unit tests (Jest)**: ``` composer admin:unit ``` - **Acceptance tests (Playwright)**: ``` composer admin:acceptance ``` More details (including Playwright install steps) can be found in the [acceptance tests README](tests/acceptance/README.md). ### Updating visual regression snapshots [](#updating-visual-regression-snapshots) Visual regression tests compare screenshots against baseline images. When UI changes are intentional, update the snapshots via CI to ensure consistency across environments: 1. Go to **Actions** > **Acceptance** workflow 2. Click **Run workflow** 3. Check **Update snapshots** 4. Run the workflow and wait for completion 5. Download the `visual-snapshots-trunk` artifact 6. Extract and replace `tests/acceptance/snapshots/` with the downloaded files 7. Commit the updated snapshots to your branch ### Import Shopware 5 fixture database (optional) [](#import-shopware-5-fixture-database-optional) This imports `tests/_fixtures/database/shopware55.sql` into the database configured in your Shopware root `.env` via `DATABASE_URL`. ``` composer install5db ``` Release notes / upgrades ------------------------ [](#release-notes--upgrades) - **Changelog**: [`CHANGELOG.md`](CHANGELOG.md) - **Breaking changes**: [`UPGRADE.md`](UPGRADE.md) License ------- [](#license) `MIT` See [`LICENSE`](LICENSE). ### Health Score 62 — FairBetter than 99% of packages Maintenance88 Actively maintained with recent releases Popularity41 Moderate usage in the ecosystem Community30 Small or concentrated contributor base Maturity76 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~33 days Recently: every ~60 days Total 75 Last Release 62d ago Major Versions 12.0.0 → 13.0.02024-07-08 13.2.0 → 14.0.02024-12-19 6.6.x-dev → 14.1.02025-03-14 14.1.0 → 15.0.12025-05-08 15.0.4 → 16.0.02026-03-02 ### Community Maintainers ![](https://www.gravatar.com/avatar/7c45ef9077b73fce78afbfab2fa27e611a453dd77de003e2785ac84105d02bef?d=identicon)[shyim](/maintainers/shyim) --- Top Contributors [![King-of-Babylon](https://avatars.githubusercontent.com/u/31991012?v=4)](https://github.com/King-of-Babylon "King-of-Babylon (685 commits)")[![htkassner](https://avatars.githubusercontent.com/u/17738609?v=4)](https://github.com/htkassner "htkassner (415 commits)")[![MalteJanz](https://avatars.githubusercontent.com/u/18661391?v=4)](https://github.com/MalteJanz "MalteJanz (328 commits)")[![mitelg](https://avatars.githubusercontent.com/u/6985627?v=4)](https://github.com/mitelg "mitelg (265 commits)")[![DennisGarding](https://avatars.githubusercontent.com/u/11271248?v=4)](https://github.com/DennisGarding "DennisGarding (61 commits)")[![larskemper](https://avatars.githubusercontent.com/u/56638588?v=4)](https://github.com/larskemper "larskemper (58 commits)")[![jozsefdamokos](https://avatars.githubusercontent.com/u/4200875?v=4)](https://github.com/jozsefdamokos "jozsefdamokos (51 commits)")[![marcelbrode](https://avatars.githubusercontent.com/u/40024364?v=4)](https://github.com/marcelbrode "marcelbrode (41 commits)")[![mstegmeyer](https://avatars.githubusercontent.com/u/40475653?v=4)](https://github.com/mstegmeyer "mstegmeyer (34 commits)")[![ennasus4sun](https://avatars.githubusercontent.com/u/111430351?v=4)](https://github.com/ennasus4sun "ennasus4sun (15 commits)")[![vintagesucks](https://avatars.githubusercontent.com/u/13335308?v=4)](https://github.com/vintagesucks "vintagesucks (14 commits)")[![tamvt](https://avatars.githubusercontent.com/u/40353989?v=4)](https://github.com/tamvt "tamvt (12 commits)")[![janbuecker](https://avatars.githubusercontent.com/u/736986?v=4)](https://github.com/janbuecker "janbuecker (11 commits)")[![whizzymind](https://avatars.githubusercontent.com/u/22935668?v=4)](https://github.com/whizzymind "whizzymind (10 commits)")[![jleifeld](https://avatars.githubusercontent.com/u/14929254?v=4)](https://github.com/jleifeld "jleifeld (8 commits)")[![vienthuong](https://avatars.githubusercontent.com/u/22548423?v=4)](https://github.com/vienthuong "vienthuong (7 commits)")[![shyim](https://avatars.githubusercontent.com/u/6224096?v=4)](https://github.com/shyim "shyim (5 commits)")[![keulinho](https://avatars.githubusercontent.com/u/15930605?v=4)](https://github.com/keulinho "keulinho (5 commits)")[![leduc92](https://avatars.githubusercontent.com/u/5572854?v=4)](https://github.com/leduc92 "leduc92 (4 commits)")[![aragon999](https://avatars.githubusercontent.com/u/6317761?v=4)](https://github.com/aragon999 "aragon999 (3 commits)") --- Tags migrationpluginshopware ### Embed Badge ![Health badge](/badges/swag-migration-assistant/health.svg) ``` [![Health](https://phpackages.com/badges/swag-migration-assistant/health.svg)](https://phpackages.com/packages/swag-migration-assistant) ``` ### Alternatives [frosh/tools Provides some basic things for managing the Shopware Installation 79709.7k2](/packages/frosh-tools)[frosh/development-helper Development Helper 90286.1k](/packages/frosh-development-helper)[shopware-pwa/shopware-pwa Shopware PWA extension 4074.0k](/packages/shopware-pwa-shopware-pwa)[werkstattl/openblogware OpenBlogware: A Blog Module for Shopware 6. 415.7k](/packages/werkstattl-openblogware)[basecom/sw6-fixtures-plugin basecom Fixtures Plugin 18185.5k](/packages/basecom-sw6-fixtures-plugin)[frosh/product-compare A Simple Product Compare plugin for Shopware 6 4032.8k](/packages/frosh-product-compare) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)