1. Der Ablauf in drei Phasen
Shopware teilt die Migration in drei Phasen. In der Vorbereitungsphase prüfst du die Systemvoraussetzungen, richtest die Migrationsumgebung ein und installierst Shopware 6. In der Migrationsphase werden die Daten übernommen. Die Migration lässt sich laut Doku über einen längeren Zeitraum immer wieder ausführen, damit die Daten in der Shopware-6-Testinstallation aktuell bleiben. In der Abschlussphase stellst du den neuen Shop live.
Technisch brauchst du zwei Erweiterungen: den SwagMigrationAssistent in Shopware 6 und den SwagMigrationConnector im alten Shopware-5-Shop. Die Verbindung startest du in der Shopware-6-Administration unter Einstellungen > Erweiterungen > Migration. Du verbindest dich entweder per API (API-Schlüssel eines Shopware-5-Benutzers aus der Gruppe „local_admins“, Benutzername, Shopdomain) oder lokal direkt mit der Datenbank (Host, Port, Benutzer, Passwort, Datenbankname und Root-Verzeichnis von Shopware 5).
- Systemvoraussetzungen für Shopware 6 prüfen und die Migrationsumgebung (Lizenzen) vorbereiten.
- Shopware 6 installieren, SwagMigrationAssistent dort und SwagMigrationConnector im Shopware-5-Shop installieren.
- Zahlungsarten, Anreden und Lieferzeiten in Shopware 6 anlegen, bevor die Migration startet.
- Verbindung unter Einstellungen > Erweiterungen > Migration herstellen, keinen Bindestrich im Verbindungsnamen verwenden.
- Daten auswählen, migrieren, im neuen Shop prüfen und bei Bedarf erneut migrieren.
- Livegang: Lizenzierungshost und Domains umtragen, danach die Migration abschließen.
2. Was automatisch übernommen wird
Im Assistenten wählst du Datenpakete aus. Die Basisdaten sind Pflicht, alles andere wählst du nach Bedarf. Zu den Basisdaten gehören Kategorien, Kundengruppen, Währungen, Verkaufskanäle und Nummernkreise. Jeder Haupt- und Subshop aus Shopware 5 wird in Shopware 6 als eigener Verkaufskanal angelegt.
Ein Detail fällt leicht durch: Einige Metadaten werden laut Doku nach 255 Zeichen abgeschnitten, weil sich der Datentyp ändert. Betroffen sind die Artikelbeschreibung (s_articles.description) sowie Meta-Description und Meta-Keywords der Kategorien. Lange Beschreibungen prüfst du nach der Migration also gezielt.
- Produkte mit Eigenschaften, Produktoptionen, Übersetzungen, Cross Selling und Hauptvarianten.
- Kunden, Versandmethoden, Bestellungen und Bestelldokumente.
- SEO-URLs.
- Rabatte und Aktionen.
- Produktbewertungen.
- Medien.
3. Was du vorher anlegen oder danach neu bauen musst
Zahlungsarten, Standard-Zahlungsart, Anreden, Lieferzeiten und Standard-Lieferzeit ordnest du während der Migration zu. Sie müssen in Shopware 6 schon angelegt sein, bevor du startest. Hast du in Shopware 5 Plugins genutzt, können weitere Felder dazukommen. Wichtig laut Doku: Auch wenn du die Migration zurücksetzt, kannst du die Felder nicht erneut zuordnen. Dafür musst du die Migration löschen und neu anlegen.
Einiges übernimmt der Assistent gar nicht. Versandkosten legst du neu an, weil Shopware 6 sie über den Rule Builder abbildet (Einstellungen > Handel > Versand). E-Mail-Vorlagen baust du neu, weil Shopware 6 Twig verwendet. Einkaufswelten und Shopseiten gehen in Shopware 6 in den Erlebniswelten auf und müssen neu erstellt werden. Alte Templates lassen sich nicht weiterverwenden, Shopware 6 bringt ein eigenes Standard-Theme mit, das als Grundlage für ein eigenes Theme dient. Daten aus der B2B-Suite von Shopware 5 lassen sich nicht übernehmen.
Die SEO-URLs kommen zwar mit, die SEO-Einstellungen laut Doku aber nicht. Prüfe also nach der Migration die SEO-URL-Vorlagen, Meta-Angaben und die Sitemap, wie im Artikel zu Shopware SEO beschrieben.
- Versandkosten neu anlegen (Rule Builder).
- Zahlungsarten prüfen und ergänzen (Einstellungen > Handel > Zahlungsarten).
- Länder prüfen (Einstellungen > Regional > Länder).
- Dokumentvorlagen mit Briefkopf und Kontodaten versehen (Einstellungen > Handel > Dokumente).
- E-Mail-Vorlagen neu aufbauen (Einstellungen > Inhalte > E-Mail-Templates).
- Einkaufswelten als Erlebniswelten neu erstellen, Theme neu umsetzen.
- SEO-Einstellungen und Domains der Verkaufskanäle prüfen.
4. Livegang und Abschluss
Für den Livegang trägst du im neuen Shop zuerst den Lizenzierungshost auf die Hauptdomain um (Einstellungen > System > Shopware Account) und danach die Domain in jedem Verkaufskanal, für jeden Subshop einzeln. Den alten Shopware-5-Shop legst du laut Doku in einen Unterordner und trägst ihn unter Einstellungen > Shopeinstellungen > Shops entsprechend ein. Beim Hoster muss die Shopdomain auf das Verzeichnis /public/ der Shopware-6-Installation zeigen.
Stimmen alle Daten, schließt du die Migration unter Einstellungen > Erweiterungen > Migrations-Assistent über „Migrationsdaten aufräumen“ ab. Danach lassen sich keine Daten mehr über die Migration aktualisieren. Hast du über den Plugin-Migrationsassistenten Testlizenzen gebucht, finalisierst du dort zuerst die Migration. Shopware empfiehlt außerdem, vor dem Livegang beide Shops nebeneinander durchzugehen, etwa die Artikeldetailseite und einen kompletten Bestellabschluss.
5. Nach der Migration: die Suche testen
Die Sucheinstellungen stehen nicht in der Liste der Daten, die der Assistent übernimmt. Hast du in Shopware 5 die „Intelligente Suche“ genutzt, war das ein Plugin für Shopware 5. In Shopware 6 stellst du die Standardsuche unter Einstellungen > Allgemein > Suche neu ein. Teste sie vor dem Livegang mit echten Suchbegriffen deiner Kunden, also mit Tippfehlern, Wortteilen und Artikelnummern.
Reicht die Standardsuche nicht, ist eine externe Suche eine Option. Grumeria liest die Produkte über einen Produktfeed und wird mit einem kostenlosen Plugin eingebunden, die Tarife beginnen bei 29 € netto im Monat, die ersten 14 Tage sind kostenlos. Ob dein Feed passt, prüfst du vorab ohne Anmeldung.
Häufige Fragen
Wie migriere ich von Shopware 5 auf Shopware 6?
Mit dem Migrationsassistenten von Shopware: SwagMigrationAssistent in Shopware 6 und SwagMigrationConnector in Shopware 5 installieren, unter Einstellungen > Erweiterungen > Migration per API oder Datenbank verbinden, Daten auswählen und migrieren. Die Migration lässt sich wiederholen, bis du live gehst.
Welche Daten übernimmt der Shopware-Migrationsassistent?
Laut Shopware-Doku Kategorien, Kundengruppen, Währungen, Verkaufskanäle und Nummernkreise als Basisdaten, dazu nach Wahl Produkte mit Varianten und Übersetzungen, Kunden, Bestellungen und Bestelldokumente, SEO-URLs, Rabatte und Aktionen, Bewertungen und Medien.
Was wird bei der Migration nicht übernommen?
Versandkosten, E-Mail-Vorlagen, Einkaufswelten und Shopseiten, das Template, die SEO-Einstellungen und Daten aus der B2B-Suite. Diese legst du in Shopware 6 neu an. Zahlungsarten, Anreden und Lieferzeiten müssen vor dem Start in Shopware 6 angelegt sein.
Kann ich die Migration mehrfach ausführen?
Ja. Solange die Verbindung zum Shopware-5-Shop besteht, kannst du Daten erneut migrieren. Erst wenn du die Migration mit „Migrationsdaten aufräumen“ abschließt, ist keine Aktualisierung über die Migration mehr möglich.