Shop & E-CommerceRedaktion Die Netzhandwerker · 18. November 2026 · 11 Min. Lesezeit

Shopware 5 auf 6 migrieren: Was der Migrationsassistent übernimmt und was Sie von Hand neu bauen müssen

Zwei Personen planen im Büro eines Onlinehändlers an zwei Laptops die Umstellung des Shops, im Hintergrund stehen Versandkartons im Regal.

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.

5.4.0 bis 5.7.20Shopware-5-Versionen, mit denen der Migration Connector laut Store-Eintrag zusammenarbeitet
6 SchritteLesen, Fehlerbehebung, Schreiben, Herunterladen, Aufräumen, Indexieren
255 ZeichenDanach werden bestimmte Meta-Felder bei der Übernahme abgeschnitten
2024Ende der Entwicklung von Shopware 5

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

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.description sowie metadescription und metakeywords aus s_categories nach 255 Zeichen abgeschnitten. Aus s_article.description entsteht die Meta-Beschreibung des Produkts. Die Langbeschreibung aus description_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.

DatenartAutomatischMit PrüfungManuell neu
ArtikelProdukte, Hersteller, Eigenschaften, Übersetzungen, Cross-Selling, KategorienLangbeschreibungen auf Vollständigkeit, Meta-Beschreibungen über 255 Zeichen (werden gekürzt), Freitextfelder als Zusatzfelder, BewertungenEinkaufswelten als Erlebniswelten (Shopping Experiences)
VariantenProduktoptionen und Beziehungen zum HauptartikelAuswahl und Anzeige der Varianten auf der ArtikelseiteVarianten-Darstellung aus Plugins des alten Themes
Kunden und PasswörterKunden, Kundengruppen, Passwort-Hashes (bcrypt direkt, md5 und sha256 als Altpasswort)Zuordnung der Anreden vor dem Start, Anmeldung mit einem echten TestkontoDaten aus der B2B Suite
BestellungenBestellungen und Bestelldokumente, Nummernkreise als GrunddatenBestellstatus, Startwerte der Nummernkreise, offene BestellungenKopf- und Kontodaten in den neu gestalteten Dokumentvorlagen
MedienDateien werden im Schritt „Herunterladen“ aus dem alten Shop geholtLogbuch auf fehlgeschlagene Downloads, Stichproben der BilderNichts, solange die Quelle erreichbar ist
ZahlungsartenNichts von der KonfigurationZuordnung alter zu neuen Zahlungsarten, inklusive StandardzahlungsartZahlungsarten, Regeln im Rule Builder, Zahlungs-Plugins in Shopware-6-Fassung
VersandartenVersandarten, Preisstaffeln nach Gewicht, Preis oder Stückzahl, bestimmte Berechnungs- und VerfügbarkeitsregelnZuordnung der Lieferzeiten inklusive Standardlieferzeit, alle übernommenen Preise und Regeln, Logbuch auf übersprungene StaffelnStaffeln mit Faktor, Zuschlagsberechnung, eigene SQL-Bedingungen
PluginsPlugin-Daten, soweit sie in der Datenauswahl erscheinenOb der Hersteller ein eigenes Migrationsprofil hatDas Plugin selbst: Shopware-6-Version beschaffen oder neu entwickeln lassen
ThemeNichtsNichtsEigenes Theme auf Basis des Shopware-6-Standards
MailvorlagenNichtsNichtsAlle angepassten Vorlagen in Twig neu schreiben
SEO-URLsSEO-URLs zu den übertragenen Artikeln und KategorienDomain je Verkaufskanal, Stichproben alter AdressenWeiterleitungen für Adressen, die nicht mehr existieren
Passwörter

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.

Nummernkreise

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.

  1. 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.
  2. 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.
  3. 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.
  4. Verbindung anlegen. Das geht unter Settings > Extensions > Migration. Wählen Sie einen einfachen Namen für die Verbindung.
  5. 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.
  6. 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.
  7. Logbuch auswerten. Über „Download log“ laden Sie das vollständige Protokoll herunter. Unter „History“ finden Sie über „Show details“ frühere Läufe.
  8. 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.
  9. 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.
Passend dazu

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

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.

Ihr Onlineshop soll so arbeiten wie Ihr Betrieb?

Wir bauen Onlineshops als Unikat mit eigenem Quelltext und übernehmen Produkte, Kunden und Bestellungen aus Ihrem bisherigen System.

Onlineshop nach Maß ansehen →

Weiterlesen — verwandte Artikel

Onlineshop & Shopware

Shopware 6 verschickt keine Mails: Ursachen finden und in vier Stufen prüfen

Shopware Mails werden nicht versendet? Mit dieser Prüfreihenfolge finden Sie den Fehler: Mailer, Message Queue, Flow Builder und Zustellung.

Webseite & Auftrag

Webseite bauen lassen: Ablauf in sieben Schritten und was Sie liefern müssen

Von der Anfrage bis zur Übergabe: die sieben Schritte beim Webseiten-Bau, was Sie selbst liefern müssen, wie die Abnahme läuft und warum Projekte fast immer an der Zuarbeit hängen.

Onlineshop & Technik

Shopware 6.4 auf 6.7: Was beim Update bricht und wann ein Neuaufbau klüger ist

Drei Hauptversionen Rückstand, kein Sicherheitsupdate seit Mai 2025: Was auf dem Weg von Shopware 6.4 nach 6.7 bricht, in welcher Reihenfolge man prüft und wann ein Neuaufbau mit Datenübernahme der kürzere Weg ist.

Voriger Artikel Apps ohne Play Store: Was auf SHIFT, Volla und Fairphone wirklich läuft Nächster Artikel Shopware 6 verschickt keine Mails: Ursachen finden und in vier Stufen prüfen

Beschreiben Sie Ihr Anliegen

Schreiben Sie uns kurz, worum es geht. Wir prüfen die Anfrage und melden uns per E-Mail mit dem nächsten Schritt.

Häufig gestellte Fragen

Kann ich Shopware 5 einfach auf Shopware 6 updaten?

Nein. Shopware 6 ist ein eigenständiges System. Sie installieren es neu und übertragen die Daten mit dem Migration Assistant aus dem alten Shop.

Müssen meine Kunden nach der Migration ein neues Passwort vergeben?

In der Regel nicht. Shopware 6 übernimmt die alten Passwörter und speichert sie bei der ersten Anmeldung neu. Testen Sie das trotzdem mit einem echten Konto.

Kann ich die Migration mehrmals laufen lassen?

Ja. Unveränderte Daten erkennt der Assistent über Prüfsummen und überspringt sie. Wenn Sie alles neu schreiben wollen, setzen Sie die Prüfsummen in der Migrationsübersicht zurück. Nach „Truncate migration“ ist kein weiterer Abgleich mehr möglich.

Bleiben meine Google-Adressen erhalten?

Der Assistent überträgt SEO-URLs zu Artikeln und Kategorien. Prüfen Sie trotzdem Stichproben der alten Adressen. Für Seiten, die es nicht mehr gibt, zum Beispiel frühere Einkaufswelten, brauchen Sie eine Weiterleitung.

Funktionieren meine Shopware-5-Plugins unter Shopware 6?

Nein. Plugins sind Programmcode und werden nicht übertragen. Sie brauchen je Plugin eine Shopware-6-Version des Herstellers oder einen Ersatz. Plugin-Daten kommen nur mit, wenn sie in der Datenauswahl erscheinen oder der Hersteller ein eigenes Migrationsprofil liefert.

Welche Shopware-5-Version brauche ich für die Migration?

Für die Verbindung über die API gibt der Store-Eintrag des Migration Connectors die Shopware-Versionen 5.4.0 bis 5.7.20 an. Alternativ verbindet sich der Assistent direkt mit der Datenbank und dem Installationsverzeichnis des alten Shops.

Branchen-Fachwissen SHK, Elektro, Maler
Beispiele aus dem Haus KI-Anwendungen, die wir selbst betreiben
Alle KI-Lösungen → Alles einzeln gebaut, nichts von der Stange.
Alle Software-Leistungen → Alles einzeln gebaut, nichts von der Stange.
Computer & Laptops PC, Mac, Kaufberatung
Mobilgeräte Smartphone, TV, Fotos
Peripherie & Netzwerk Drucker, WLAN, NAS
Alle Hardware-Leistungen → Alles einzeln gebaut, nichts von der Stange.
Alle Privat-Leistungen → Alles einzeln gebaut, nichts von der Stange.
Alle Unternehmens-Leistungen → Alles einzeln gebaut, nichts von der Stange.
linkx© Hub + Module QR-Code für digitale Abläufe
linkx© Module II Pflegeheim, Schule, Wache, Wahl
Alle Submarken → Alles einzeln gebaut, nichts von der Stange.
Alle Artikel im Wissensbereich → Alles einzeln gebaut, nichts von der Stange.