Shopware 5 auf 6 migrieren: Was der Migrationsassistent übernimmt und was Sie von Hand neu bauen müssen
Der offizielle Migration Assistant von Shopware überträgt die Daten Ihres Shopware-5-Shops: Artikel mit Varianten, Kunden samt Passwörtern, Bestellungen, Medien, Kategorien und SEO-URLs. Versandarten mit unterstützten Preisstaffeln und bestimmten Regeln kommen ebenfalls mit, Sonderberechnungen nicht. Nicht mit kommen das Theme, die Mailvorlagen, Einkaufswelten und die Konfiguration der Zahlungsarten. Plugins brauchen Sie in einer Shopware-6-Fassung. Sie richten also Grundlagen vorher ein, lassen die Daten übertragen und bauen Darstellung und fehlende Regeln in Shopware 6 neu auf.
Stand 18.11.2026. Grundlage: Herstellerdokumentation zum Shopware Migration Assistant für Shopware 6.7.0.0 und neuer (Erweiterungsversion 16.0.0), der Quellcode des Assistenten im Release 16.0.0, der Quellcode von Shopware 6.7.0.0 und der Store-Eintrag zum Migration Connector. Wo Herstellerseiten und Quellcode voneinander abweichen, ist das im Text benannt.
- Die kurze Antwort
- Woran Sie erkennen, dass die Migration hakt
- Warum nicht alles automatisch mitkommt
- Übernahme-Matrix: was mitkommt, was Sie prüfen, was Sie neu bauen
- Die Migration in der richtigen Reihenfolge
- Prüfliste für den Testlauf vor dem Umschalten
- Wann es komplizierter wird
- Umschalten und Vorbeugung
Die kurze Antwort
Shopware 6 ist kein Update von Shopware 5, sondern ein neues System. Deshalb gibt es auch keinen Update-Knopf. Den Wechsel erledigen Sie über eine frische Shopware-6-Installation und die Erweiterung Migration Assistant. Die verbindet sich mit dem alten Shop und holt sich die Daten.
Als Faustregel gilt: Daten kommen mit, das Aussehen nicht, die Logik nur zum Teil. Theme, Mailvorlagen und Einkaufswelten bauen Sie in Shopware 6 neu. Versandkosten überträgt der Assistent nur für bestimmte Berechnungsarten; das Ergebnis prüfen Sie vollständig. Zahlungsarten, Lieferzeiten und Anreden müssen Sie vor dem Start in Shopware 6 anlegen, damit der Assistent die alten Werte zuordnen kann.
Die Entwicklung von Shopware 5 endete 2024. Wer noch auf Shopware 5 arbeitet, sollte die Migration deshalb früh planen.
Woran Sie erkennen, dass die Migration hakt
Nach einem ersten Testlauf zeigen sich die Lücken meist an denselben Stellen:
- Die Artikel sind da, aber der Shop sieht anders aus. Das ist normal, denn das alte Theme wird nicht übernommen.
- Im Checkout fehlen Zahlungsarten, oder die Versandkosten stimmen nicht. Die Konfiguration der Zahlungsarten überträgt der Assistent nicht, Versandkosten nur für bestimmte Berechnungsarten.
- Bestellbestätigungen enthalten nur den Standardtext. Ihre angepassten Mailvorlagen aus Shopware 5 kommen nicht mit.
- Startseite und Landingpages sind leer. Einkaufswelten werden nicht übertragen.
- Funktionen eines Plugins fehlen, oder seine Daten tauchen nicht auf.
- Das Logbuch der Migration zeigt Fehler oder Warnungen zu einzelnen Datensätzen.
Die meisten dieser Punkte sind kein Fehler des Assistenten. Sie liegen im Aufbau von Shopware 6 begründet und lassen sich einplanen.
Warum nicht alles automatisch mitkommt
Shopware 6 löst viele Aufgaben anders als Shopware 5. Daraus ergeben sich vier Gründe, warum Teile neu gebaut werden müssen:
- Neue Template-Technik: Mailvorlagen nutzen in Shopware 6 die Vorlagensprache Twig. Die alten Vorlagen lassen sich deshalb nicht weiterverwenden. Auch das Theme ist laut Hersteller weder nutzbar noch migrierbar. Als Ausgangspunkt dient das mitgelieferte Standard-Theme.
- Regeln statt Einstellungen: Versandkosten und die frühere Risikoprüfung bei Zahlungsarten laufen in Shopware 6 über den Rule Builder. Die Risikoprüfung der Zahlungsarten legen Sie dort neu an. Bei Versandarten ist es differenzierter: Die Herstellerseite „What is migrated“ nennt Versandkosten als nicht übertragbar, der Quellcode des Assistenten (Release 16.0.0) überträgt sie aber teilweise. Aus Staffeln nach Gewicht, Preis oder Stückzahl erzeugt er Versandpreise. Dazu legt er Regeln an, etwa zu Lieferländern, Zahlungsarten, Gewichts- und Warenwertgrenzen, Zeiträumen und ausgeschlossenen Kategorien. Staffeln mit Faktor, die Zuschlagsberechnung und eigene SQL-Bedingungen übernimmt er nicht. Diese bauen Sie nach.
- Andere Datenfelder: Einige Felder sind in Shopware 6 kürzer. Nach Herstellerangabe werden
s_article.descriptionsowiemetadescriptionundmetakeywordsauss_categoriesnach 255 Zeichen abgeschnitten. Auss_article.descriptionentsteht die Meta-Beschreibung des Produkts. Die Langbeschreibung ausdescription_longübernimmt der Assistent als Produktbeschreibung ohne diese Kürzung. Freitextfelder werden zu Zusatzfeldern, die nach der Migrationsverbindung benannt sind. - Plugins sind Programmcode: Der Assistent überträgt Daten, aber keine Erweiterungen. Daten von Plugins erscheinen in der Auswahl als Plugin-Daten. Manche Plugin-Hersteller liefern dafür ein eigenes Migrationsprofil, das Sie dann verwenden müssen. Daten aus der B2B Suite lassen sich laut Shopware nicht übertragen.
Übernahme-Matrix: was mitkommt, was Sie prüfen, was Sie neu bauen
Die Tabelle fasst Herstellerdokumentation und Quellcode des Assistenten je Datenart zusammen. „Automatisch“ heißt: Die Daten werden übertragen, wenn Sie den Datensatz auswählen. „Mit Prüfung“ heißt: Es wird übertragen, aber Sie müssen die Zuordnung oder das Ergebnis kontrollieren. „Manuell neu“ heißt: In Shopware 6 von Hand anlegen.
| Datenart | Automatisch | Mit Prüfung | Manuell neu |
|---|---|---|---|
| Artikel | Produkte, Hersteller, Eigenschaften, Übersetzungen, Cross-Selling, Kategorien | Langbeschreibungen auf Vollständigkeit, Meta-Beschreibungen über 255 Zeichen (werden gekürzt), Freitextfelder als Zusatzfelder, Bewertungen | Einkaufswelten als Erlebniswelten (Shopping Experiences) |
| Varianten | Produktoptionen und Beziehungen zum Hauptartikel | Auswahl und Anzeige der Varianten auf der Artikelseite | Varianten-Darstellung aus Plugins des alten Themes |
| Kunden und Passwörter | Kunden, Kundengruppen, Passwort-Hashes (bcrypt direkt, md5 und sha256 als Altpasswort) | Zuordnung der Anreden vor dem Start, Anmeldung mit einem echten Testkonto | Daten aus der B2B Suite |
| Bestellungen | Bestellungen und Bestelldokumente, Nummernkreise als Grunddaten | Bestellstatus, Startwerte der Nummernkreise, offene Bestellungen | Kopf- und Kontodaten in den neu gestalteten Dokumentvorlagen |
| Medien | Dateien werden im Schritt „Herunterladen“ aus dem alten Shop geholt | Logbuch auf fehlgeschlagene Downloads, Stichproben der Bilder | Nichts, solange die Quelle erreichbar ist |
| Zahlungsarten | Nichts von der Konfiguration | Zuordnung alter zu neuen Zahlungsarten, inklusive Standardzahlungsart | Zahlungsarten, Regeln im Rule Builder, Zahlungs-Plugins in Shopware-6-Fassung |
| Versandarten | Versandarten, Preisstaffeln nach Gewicht, Preis oder Stückzahl, bestimmte Berechnungs- und Verfügbarkeitsregeln | Zuordnung der Lieferzeiten inklusive Standardlieferzeit, alle übernommenen Preise und Regeln, Logbuch auf übersprungene Staffeln | Staffeln mit Faktor, Zuschlagsberechnung, eigene SQL-Bedingungen |
| Plugins | Plugin-Daten, soweit sie in der Datenauswahl erscheinen | Ob der Hersteller ein eigenes Migrationsprofil hat | Das Plugin selbst: Shopware-6-Version beschaffen oder neu entwickeln lassen |
| Theme | Nichts | Nichts | Eigenes Theme auf Basis des Shopware-6-Standards |
| Mailvorlagen | Nichts | Nichts | Alle angepassten Vorlagen in Twig neu schreiben |
| SEO-URLs | SEO-URLs zu den übertragenen Artikeln und Kategorien | Domain je Verkaufskanal, Stichproben alter Adressen | Weiterleitungen für Adressen, die nicht mehr existieren |
Kunden müssen sich in der Regel kein neues Passwort setzen. Der Assistent übernimmt bcrypt-Hashes direkt ins Passwortfeld. md5- und sha256-Hashes speichert er als Altpasswort mit dem passenden Verfahren. Bei der ersten erfolgreichen Anmeldung prüft Shopware 6 das alte Passwort, speichert es neu und löscht die Altfelder.
Laut Shopware gehören Nummernkreise zu den Grunddaten, die übertragen werden. Pickware rät dagegen, sie neu anzulegen und mit Abstand über die letzte Shopware-5-Nummer zu setzen. Prüfen Sie deshalb nach jedem Testlauf, mit welcher Nummer die nächste Rechnung startet.
Die Migration in der richtigen Reihenfolge
Die Reihenfolge folgt der Herstellerdokumentation für Shopware 6.7 und den Migration Assistant in Version 16.0.0. Die Menüpfade stehen so in der englischen Dokumentation.
- Shopware 6 getrennt installieren. Nutzen Sie dafür eine eigene Installation, nicht den laufenden Shop. Installieren Sie dort den Migration Assistant aus dem Community Store.
- Den alten Shop anbinden. Es gibt zwei Wege. Für die Verbindung über die API installieren Sie im Shopware-5-Shop den Migration Connector. Laut Store-Eintrag läuft er mit Shopware 5.4.0 bis 5.7.20. Sie brauchen den API-Schlüssel eines Benutzers aus der Gruppe „local_admins“, den Benutzernamen und die Shop-Domain. Bei der lokalen Verbindung geben Sie die Zugangsdaten der Datenbank an und den absoluten Pfad zur Shopware-5-Installation. Legen Sie vorher eine Sicherung an.
- Grundlagen in Shopware 6 anlegen. Legen Sie Zahlungsarten, Anreden und Lieferzeiten vor dem Start an, jeweils mit einem Standardwert. Ohne diese Einträge kann der Assistent die alten Werte nicht zuordnen.
- Verbindung anlegen. Das geht unter Settings > Extensions > Migration. Wählen Sie einen einfachen Namen für die Verbindung.
- Datencheck und Zuordnung. Der Assistent zeigt, welche Werte er nicht selbst zuordnen kann. Diese ordnen Sie von Hand zu. Unter „Processed assignments“ prüfen Sie außerdem die automatischen Zuordnungen. Laut Prozessdokumentation können Sie dort Ihre Zuordnungen auch später bearbeiten. Davon zu unterscheiden ist das Zurücksetzen einer Migration. Dazu enthält die Herstellerseite „What is migrated“ einen abweichenden Hinweis, der sich keiner Version eindeutig zuordnen lässt. Prüfen und bearbeiten Sie Zuordnungen deshalb zuerst unter den Zuweisungen, bevor Sie eine Migration zurücksetzen.
- Daten auswählen und starten. Haken Sie die gewünschten Datensätze an und klicken Sie auf „Start Migration“. Sechs Schritte laufen nacheinander: Lesen, Fehlerbehebung, Schreiben, Herunterladen der Medien, Aufräumen und Indexieren. Bei fehlerhaften Datensätzen hält der Lauf an. Sie können die Daten dann korrigieren, ohne neu starten zu müssen.
- Logbuch auswerten. Über „Download log“ laden Sie das vollständige Protokoll herunter. Unter „History“ finden Sie über „Show details“ frühere Läufe.
- Nacharbeiten. Prüfen Sie die übernommenen Versandarten und Preise vollständig und bauen Sie nicht unterstützte Berechnungen und Sonderregeln nach (Settings > Commerce > Shipping). Prüfen Sie die Zahlungsarten und ergänzen Sie fehlende (Settings > Commerce > Payment methods). Prüfen Sie, ob alle für Sie relevanten Länder vorhanden und aktiv sind, und ergänzen Sie fehlende (Settings > Localisation > Countries). Hinterlegen Sie in den Dokumentvorlagen Ihre Firmen- und Bankdaten; zusätzliche Vorlagen legen Sie nur bei Bedarf an (Settings > Commerce > Documents). Passen Sie die Mailvorlagen an (Settings > Content > Email templates) und legen Sie die Erlebniswelten neu an (Content > Shopping Experiences). Hinzu kommen das Theme und die Plugins.
- Erneut übertragen. Sie können die Migration beliebig oft wiederholen. Über eine Prüfsumme erkennt der Assistent unveränderte Daten und überspringt sie. Wenn Sie alles neu schreiben wollen oder Änderungen nicht ankommen, setzen Sie die Prüfsummen in der Migrationsübersicht zurück.
Mit dem Ergebnis der Erstübertragung geht der Shop noch nicht live. Sie arbeiten an Theme, Mails und Regeln, während Shopware 5 weiterläuft. Kurz vor dem Umschalten übertragen Sie den aktuellen Stand noch einmal.
Prüfliste für den Testlauf vor dem Umschalten
Shopware empfiehlt, nach der Migration die Kernfunktionen beider Shops zu vergleichen, etwa die Artikelseite und den Bestellabschluss. Die folgende Liste macht daraus konkrete Prüfschritte:
- Das Logbuch des letzten Laufs ist durchgesehen. Jeder Fehler ist behoben oder bewusst akzeptiert.
- Die Artikelzahl und die Zahl der Varianten stimmen mit Shopware 5 überein. Prüfen Sie das stichprobenartig in mehreren Kategorien.
- Die Langbeschreibungen der Artikel sind vollständig. Meta-Beschreibungen und Kategorie-Meta-Texte über 255 Zeichen sind gekürzt. Bringen Sie betroffene Texte bei Bedarf vor der Migration redaktionell auf höchstens 255 Zeichen.
- Bilder erscheinen auf Artikel- und Kategorieseiten. Es fehlen keine Medien.
- Variantenauswahl, Preise und Kundengruppenpreise stimmen.
- Ein Testkunde mit altem Passwort kann sich anmelden. Prüfen Sie danach, ob das Kundenkonto Adressen und Bestellhistorie zeigt.
- Jede Zahlungsart wurde einmal vollständig bezahlt, auch im Testmodus des Zahlungsanbieters.
- Die Versandkosten stimmen für jedes Land, jede Gewichtsstufe und die Versandkostenfreigrenze.
- Bestellbestätigung, Versandmail und Passwort-Mail kommen an und enthalten Ihre Texte.
- Rechnung und Lieferschein enthalten Kopfdaten und Kontoverbindung. Die nächste Rechnungsnummer liegt über der letzten aus Shopware 5.
- Alte Artikel- und Kategorieadressen führen auf die richtige Seite.
- Rechtstexte, Cookie-Hinweis und Kontaktformular funktionieren.
- Jedes Plugin aus Shopware 5 hat einen Ersatz in Shopware 6 oder wird bewusst nicht mehr gebraucht.
- Offene Bestellungen sind in Shopware 5 abgeschlossen, bevor Sie zum letzten Mal übertragen.
Fehlt nach dem Import etwas, das in Shopware 5 vorhanden war, finden Sie im Beitrag Daten fehlen nach dem Import eine Anleitung zur Eingrenzung.
Wann es komplizierter wird
Mit einem Standard-Shop, wenigen Plugins und einem leicht angepassten Theme kommen Sie mit dem Assistenten und etwas Nacharbeit gut zurecht. Aufwendiger wird es in diesen Fällen:
- Plugins mit eigenen Daten: Ein Plugin-Hersteller ohne Shopware-6-Version oder ohne eigenes Migrationsprofil hinterlässt eine Lücke. Pickware nennt zum Beispiel für die eigenen Daten wie Lagerplätze, Bestände und Lieferanten keine automatische Übernahme, sondern einen manuellen Weg über CSV.
- Selbst entwickelte Erweiterungen: Eigene Shopware-5-Plugins müssen für Shopware 6 neu entwickelt werden, ebenso Anbindungen an Warenwirtschaft oder Marktplätze.
- Mehrere Subshops: Jeder Haupt- und Subshop wird zu einem eigenen Verkaufskanal. Für jeden müssen Sie die Domain einstellen.
- B2B-Funktionen: Daten aus der B2B Suite lassen sich nicht übertragen.
- Laufende Buchhaltung: Pickware rät, Bestellungen aus Shopware 5 dort vollständig abzuschließen, einschließlich Rechnung, Erstattung und DATEV-Export. Wenn Sie zusätzlich auf E-Rechnungen umstellen, hilft der Beitrag E-Rechnung in WooCommerce und Shopware.
Wenn der Testlauf an Plugins, Zahlungsarten oder Mails hängen bleibt und die Ursache im Logbuch nicht klar wird, lohnt sich ein zweiter Blick von außen. Die Netzhandwerker grenzen solche Fälle im Rahmen von Shop-Störung beheben ein.
Umschalten und Vorbeugung
Für den Go-live beschreibt Shopware diese Schritte:
- Den Lizenz-Host unter Settings > System > Shopware Account auf die Hauptdomain umstellen.
- In jedem Verkaufskanal die endgültige Domain eintragen.
- Den Shopware-5-Shop in ein Unterverzeichnis verschieben und diesen Ort in Shopware 5 als Shop-Adresse eintragen.
- Die Domain beim Hoster auf den Ordner
/public/der Shopware-6-Installation zeigen lassen. - Nach dem letzten Lauf unter Settings > Extensions > Migration Assistant im Kontextmenü „Truncate migration“ wählen. Danach lassen sich die Daten über diese Migration nicht mehr aktualisieren. Wählen Sie den Punkt deshalb erst, wenn der Datenstand final ist.
Zur Vorbeugung gegen spätere Überraschungen:
- Solange Sie noch Daten nachziehen, muss die Quelle erreichbar bleiben. Bei einer Verbindung über die API bleibt dafür der Migration Connector im alten Shop aktiv. Bei einer lokalen Verbindung müssen Datenbank und Installationsverzeichnis des alten Shops weiterhin erreichbar sein.
- Notieren Sie jede Zuordnung aus dem Datencheck, bevor Sie eine Migration zurücksetzen.
- Legen Sie eine Plugin-Liste an. Notieren Sie je Plugin Zweck, Shopware-6-Ersatz und Datenweg.
- Testen Sie nach dem Umschalten die meistbesuchten alten Adressen. Fehlende Seiten erkennen Sie an 404-Fehlern. Hinweise dazu stehen im Beitrag 404 Seite nicht gefunden.
Wenn nach dem Testlauf Zahlungsarten, Mails oder Plugin-Daten in Shopware 6 nicht laufen, ist das ein Fall für die Störungsbehebung. Die Netzhandwerker suchen die Ursache und beheben sie, damit Sie den Termin für das Umschalten halten können.
Mehr dazu: Shop-Störung beheben: Shopify, WooCommerce, Shopware
Quellen
- Shopware Dokumentation: What is migrated from Shopware 5 to 6, docs.shopware.com
- Shopware Dokumentation: Migration process – Shopware 5, docs.shopware.com
- Shopware Dokumentation: Check migration data and perform the migration, docs.shopware.com
- Shopware Dokumentation: Go-live, docs.shopware.com
- Shopware Dokumentation: Documents (Shopware 6), docs.shopware.com
- Shopware Developer Docs: Migration Assistant Concept, developer.shopware.com
- Shopware Store: Migration Connector, store.shopware.com
- GitHub: SwagMigrationAssistant 16.0.0, ShippingMethodConverter (Versandkostenübernahme), raw.githubusercontent.com
- GitHub: SwagMigrationAssistant 16.0.0, ProductConverter (Beschreibung und Meta-Beschreibung), raw.githubusercontent.com
- GitHub: SwagMigrationAssistant 16.0.0, CustomerConverter (Passwortübernahme), raw.githubusercontent.com
- GitHub: Shopware Core 6.7.0.0, AccountService (Altpasswort bei Anmeldung), raw.githubusercontent.com
- Pickware Hilfe: Was muss ich bei der Migration von Shopware 5 zu Shopware 6 beachten, help.pickware.com
- maxcluster: Shopware 5 End of Life – Interview mit safefive, maxcluster.de
Alle Quellen gelesen am 18.11.2026.
Erstellt von der Redaktion Die Netzhandwerker mit KI-Unterstützung. Die Sachangaben wurden vor der Veröffentlichung automatisch gegen die genannten Quellen geprüft.