swag/migration-assistant

Migration plugin for shopware/platform

Maintainers

Details

github.com/shopware/SwagMigrationAssistant

Source

Installs: 34 422

Dependents: 0

Suggesters: 0

Security: 0

Stars: 20

Watchers: 30

Forks: 25

Type:shopware-platform-plugin

pkg:composer/swag/migration-assistant

16.0.0 2026-03-02 08:48 UTC

Requires

MIT 2075f529eaf2b6da0b3d26286d1d5c7510c5c7b1

  • Shopware

This package is auto-updated.

Last update: 2026-03-03 08:34:43 UTC

README

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

Documentation

Shopware 5: Migration Connector

When migrating from Shopware 5, you can migrate locally or connect via the “Migration Connector” plugin from the Shopware Store:

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

  • Shopware: shopware/core (see version here 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)

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

  • Install JS dependencies (administration + Jest + Playwright project):
composer npm:init
  • Install git pre-commit hook (optional):
./bin/setup.sh

Common workflows

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

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

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)

This imports tests/_fixtures/database/shopware55.sql into the database configured in your Shopware root .env via DATABASE_URL.

composer install5db

Release notes / upgrades

License

MIT See LICENSE.