Wie Sie Produkte, Varianten, Kunden und Bestellungen per CSV in Shopware 6 übernehmen und welche Fehler Sie dabei vermeiden.
Der Shopware CSV Import ist ein eingebautes Modul in Shopware 6, mit dem Sie Produkte, Kunden, Kategorien und weitere Daten aus einer CSV-Datei übernehmen. Sie finden es in der Administration unter Einstellungen, Automatisierung, Import/Export. Jede Datei läuft über ein Profil, das festlegt, welche Spalte in welches Shopware-Feld geht. Die Datei muss UTF-8 kodiert sein, Semikolons als Trenner und Punkte als Dezimalzeichen verwenden.
Für einzelne Datenbereiche ist CSV der schnellste Weg, für einen kompletten Systemwechsel meist nicht. Produkte, Preise, Lagerbestände und Kundenlisten lassen sich gut per CSV pflegen. Bestellhistorie, Bewertungen, SEO-URLs und Dokumente kommen bei einem Umzug von Shopware 5 oder einem anderen Shopware 6 sauberer über den Migrationsassistenten. Laufende Abgleiche mit einer Warenwirtschaft gehören in eine Schnittstelle.
Die meisten Importfehler entstehen vor dem Upload. Excel verändert Umlaute, Trennzeichen und führende Nullen, Varianten brauchen eine feste Reihenfolge, und Kunden bekommen ohne Vorbereitung Registrierungsmails. Wer den Import nicht selbst stemmen will: Im Shop-Abo von solution25 legen wir je nach Paket bis zu 200 oder 500 Produkte an, im Enterprise-Paket ist die Datenmigration enthalten.
Dieser Beitrag richtet sich an Shopbetreiber, E-Commerce-Verantwortliche und Entwickler, die Daten in einen Shopware-6-Shop übernehmen wollen: beim Start eines neuen Shops, beim Relaunch oder bei der regelmäßigen Pflege großer Sortimente. Sie erfahren, welche Methode zu welchem Fall passt, wie Sie Profile und Dateien vorbereiten und wie Sie Produkte, Varianten, Kunden und Bestellungen ohne Datenverlust übernehmen.
Das Modul Import/Export gehört zum Standardumfang von Shopware 6. Sie brauchen dafür keine Erweiterung. In der Administration öffnen Sie Einstellungen, Automatisierung, Import/Export. Dort gibt es drei Reiter: Import, Export und Profile.
Shopware liefert Standardprofile mit, unter anderem für Produkte, Kategorien, Eigenschaften, Newsletter-Empfänger und die Variantenkonfiguration. Die Dokumentation enthält zudem Feldreferenzen für Kunden, Bestellungen, Medien, Preise, Cross-Selling und Aktionscodes. Für jeden dieser Objekttypen können Sie eigene Profile anlegen.
Beim Start prüft Shopware jeden Datensatz. Gültige Zeilen werden übernommen, fehlerhafte landen in einer eigenen CSV-Datei mit der zusätzlichen Spalte _error. Diese Datei laden Sie herunter, korrigieren sie und importieren sie erneut. Das Protokoll zeigt die Importe der letzten 30 Tage, samt Quelldatei, Profil und Fehlerdatei.
Ein wichtiger Knopf ist der Testlauf (Dry Run). Er spielt den Import vollständig durch, ohne Daten zu schreiben. So sehen Sie vorher, ob Zeilen scheitern, und vermeiden einen halb importierten Datenbestand.
Ein Import kann Daten nur hinzufügen oder überschreiben, nicht entfernen. Ein Beispiel aus der Dokumentation: Eine Verkaufskanal-Zuordnung, die einmal gesetzt ist, löschen Sie per Import nicht wieder. Wer Zuordnungen bereinigen will, muss das in der Administration oder per API tun. Auch ein Abbruch macht nichts rückgängig: Datensätze, die bis dahin geschrieben wurden, bleiben im System.
Bevor Sie die erste Datei bauen, klären Sie, ob CSV überhaupt das richtige Werkzeug ist. Shopware bietet drei Wege, Daten in den Shop zu bringen, und jeder passt zu einem anderen Fall.
| Methode | Passt für | Grenzen |
|---|---|---|
| CSV Import/Export | Ersteinrichtung von Sortimenten, Massenänderungen an Preisen und Beständen, Kundenlisten aus einem Altsystem | Keine Löschungen, Varianten nur in mehreren Schritten, Bestellungen ohne Standardanleitung |
| Migrationsassistent | Umzug von Shopware 5 oder einem anderen Shopware 6, auch Magento laut Shopware-Dokumentation | Zahlungsarten, Flows, dynamische Produktgruppen und Erweiterungsdaten müssen neu angelegt werden |
| API oder Schnittstelle | Laufender Abgleich mit Warenwirtschaft, ERP oder PIM | Entwicklungsaufwand, Betrieb und Überwachung der Schnittstelle |
CSV ist stark, wenn Daten einmalig oder in größeren Abständen kommen und die Struktur überschaubar ist. Typische Fälle: Ein Händler startet mit 800 Artikeln aus einer Lieferantenliste. Ein Shop ändert vor der Black Week die Preise von 2.000 Produkten. Ein Großhändler übernimmt seine Kundenliste aus einem alten B2B-Portal. In all diesen Fällen ist eine gut gebaute CSV in wenigen Minuten importiert.
Wenn Sie von Shopware 5 kommen, nutzen Sie den offiziellen Migrationsassistenten. Er übernimmt laut Shopware Medien, Kategorien, Produkte, Eigenschaften, Hersteller, Bewertungen, Cross-Selling, Kunden, Bestellungen samt Dokumenten, SEO-URLs, Newsletter-Empfänger, Merkzettel und Aktionen. Das per CSV nachzubauen, kostet ein Vielfaches an Zeit und verliert Beziehungen zwischen den Daten. Wie dieser Umzug abläuft, steht im Beitrag Shopware 5 auf Shopware 6 migrieren.
Sobald Daten täglich oder stündlich fließen müssen, etwa Bestände aus dem Lager oder Bestellungen zurück in die Buchhaltung, ist CSV per Hand der falsche Weg. Dann brauchen Sie eine Anbindung an Ihre Warenwirtschaft. Welche Systeme es gibt und wie die Anbindung funktioniert, beschreibt der Beitrag Shopware Warenwirtschaft. Eine Zwischenlösung sind automatisierte CSV-Importe über die Kommandozeile, dazu unten mehr.
Shopware erwartet eine echte CSV-Datei mit festen Regeln. Die Dokumentation nennt drei: UTF-8 als Zeichenkodierung, Semikolon als Feldtrenner, Anführungszeichen um Texte. Dazu kommt bei Zahlen der Punkt als Dezimaltrenner, also 5.00 und nicht 5,00.
Die meisten Händler bauen ihre Listen in Excel. Beim Speichern als CSV passieren dann drei typische Dinge: Umlaute werden falsch kodiert, aus Semikolons werden Kommas oder umgekehrt, und führende Nullen verschwinden. Aus der Artikelnummer 00451 wird 451, aus einer EAN mit 13 Stellen eine Zahl in wissenschaftlicher Schreibweise. Shopware rät deshalb in der Dokumentation zu einem Programm, das native CSV-Dateien schreibt, und nennt OpenOffice Calc als Beispiel. LibreOffice Calc oder ein Texteditor mit Kodierungsauswahl funktionieren genauso.
Der zuverlässigste Weg zur richtigen Struktur: Legen Sie zwei oder drei Testprodukte per Hand an, exportieren Sie diese mit dem Profil, das Sie später für den Import nutzen, und verwenden Sie die exportierte Datei als Vorlage. Spaltennamen, Reihenfolge und Format stimmen dann sicher. Im Shopware-Forum wird genau dieser Weg auch bei der Fehlermeldung zu nicht unterstützten Dateiformaten empfohlen. Dort berichten mehrere Nutzer, dass derselbe Upload in Firefox scheiterte und in Chrome funktionierte.
Ein Profil ist die Übersetzung zwischen Ihrer Datei und der Shopware-Datenbank. Sie können ein Standardprofil duplizieren oder ein neues anlegen. Wichtig: Wählen Sie dabei die Standardsprache des Systems, sonst funktioniert das Profil laut Dokumentation nicht.
Diese beiden Schalter sind eine einfache Schutzfunktion. Für eine reine Preisaktualisierung schalten Sie das Anlegen ab. Dann erzeugt ein Tippfehler in einer Artikelnummer kein neues, leeres Produkt, sondern landet als Fehler in der Fehlerdatei.
Im Mapping ordnen Sie jedem Datenbankfeld einen Spaltennamen zu. Pro Zeile legen Sie fest, ob das Feld Pflicht ist, welchen Standardwert es bekommt und an welcher Position es steht. Wenn Sie eine vorhandene CSV hochladen, schlägt Shopware die Felder aus der Kopfzeile vor. Die Pflichtfelder fügt das System selbst ein:
| Objekttyp | Pflichtfelder laut Dokumentation |
|---|---|
| Produkt | id, taxId, productNumber, stock, name |
| Kunde | id, defaultBillingAddressId, defaultShippingAddressId, customerNumber, firstName, lastName, email |
| Kategorie | id, type, name |
Shopware arbeitet intern mit langen UUIDs. Kein Altsystem kennt diese IDs. In den erweiterten Einstellungen des Profils können Sie deshalb ein zweites eindeutiges Merkmal bestimmen, bei Produkten typischerweise die Artikelnummer (productNumber). Dann findet Shopware beim Update das richtige Produkt über die Nummer. Achten Sie darauf, dass dieses Merkmal wirklich eindeutig ist. Doppelte Werte führen dazu, dass Datensätze übersprungen werden.
Der Produktimport ist der häufigste Fall und der, bei dem sich die meisten Details verstecken. Mit dem Standardprofil für Produkte kommen Sie weit, wenn Sie die folgenden Punkte beachten.
Preisfelder folgen dem Muster price.DEFAULT.net und price.DEFAULT.gross. DEFAULT steht für die Standardwährung. Geben Sie beide Werte an oder klären Sie vorher, welcher Wert führt. Ein häufiger Fehler ist ein Bruttopreis, der mit einem falschen Steuersatz zurückgerechnet wird, sodass im Shop krumme Cent-Beträge stehen.
Die Produktdatei kennt die Spalten tax_id, tax_rate und tax_name. Tragen Sie bei tax_id die UUID eines vorhandenen Steuersatzes ein. Bleibt das Feld leer, legt Shopware laut Dokumentation einen neuen Steuersatz an. Das klingt harmlos, führt aber schnell zu mehreren doppelten Sätzen mit demselben Prozentsatz, die später niemand mehr auseinanderhält. Holen Sie die UUIDs vorher über einen Export oder aus der Administration.
Das Feld media nimmt die URLs der Produktbilder auf, das Titelbild steht in einem eigenen Feld. Shopware lädt die Bilder von diesen Adressen herunter. Die Bilder müssen also öffentlich erreichbar sein. Links aus Cloud-Freigaben mit Ablaufdatum oder aus einem Lieferantenportal mit Login scheitern. Bei großen Sortimenten lohnt ein eigener Bilderordner auf einem Server, den Sie nach dem Import wieder leeren.
Produkte ordnen Sie über die Kategorie-IDs zu. Legen Sie die Kategoriestruktur deshalb vor den Produkten an, entweder per Hand oder mit dem Standardprofil für Kategorien. Dort bestimmt parent_id die Elternkategorie. Die ID einer Kategorie sehen Sie in der Adresszeile der Administration, wenn Sie die Kategorie öffnen.
Texte in weiteren Sprachen laufen über Felder nach dem Muster translations.DEFAULT, wobei DEFAULT durch das Sprachkürzel ersetzt wird, etwa de-DE oder en-GB. Für einen mehrsprachigen Shop planen Sie pro Sprache eine Spalte für Name, Beschreibung und Meta-Daten ein. Shopware empfiehlt, vor dem Import von Übersetzungen ein Datenbank-Backup anzulegen.
Varianten sind der Teil, an dem die meisten CSV-Importe scheitern. Der Grund: Eine Variante hängt an einem Hauptprodukt und an Eigenschaften, die beide vorher existieren müssen. Die Shopware-Dokumentation beschreibt deshalb vier Schritte.
Beim Import der Varianten sind parent_id, product_number, active, stock und optionIds Pflicht. Mehrere Options-IDs trennen Sie mit einem senkrechten Strich, also id-rot|id-xl.
Generieren ist schneller, wenn jede Kombination existieren soll und die Varianten sich nur in den Optionen unterscheiden. Importieren ist besser, wenn Sie eigene Artikelnummern, EAN, Bestände oder Preise pro Variante übernehmen müssen. In der Praxis kombinieren wir oft beides: Varianten generieren, dann Nummern, Bestände und Preise per Update-Import nachziehen. Das ist ein Erfahrungswert aus Projekten, keine Vorgabe von Shopware.
Ein hypothetischer Modehändler hat 300 Shirts in je 5 Größen und 4 Farben. Das sind 300 Hauptprodukte, 2 Eigenschaftsgruppen mit 9 Optionen, 2.700 Zeilen Variantenkonfiguration (300 mal 9) und 6.000 Varianten (300 mal 20). Wer das in eine einzige Datei packen will, scheitert. In vier sauber getrennten Dateien ist es ein überschaubarer Import.
Beim Kundenimport geht es um mehr als Namen und Adressen. Drei Punkte entscheiden, ob der Umzug für Ihre Kunden unbemerkt bleibt.
Shopware verschickt beim Anlegen eines Kunden eine Registrierungsmail. Bei 5.000 importierten Kunden wären das 5.000 Mails an Menschen, die sich nicht neu registriert haben. Die Dokumentation rät deshalb, vor dem Import den Mailversand unter Einstellungen, System, Mailer zu deaktivieren und danach wieder einzuschalten.
Kunden sollen sich nach dem Umzug mit ihrem alten Passwort anmelden können. Shopware sieht dafür die Felder legacyPassword und legacyEncoder vor. Dort stehen der verschlüsselte Hash aus dem Altsystem und das Verfahren, mit dem er erzeugt wurde. Meldet sich der Kunde an, prüft Shopware das alte Passwort und speichert es im eigenen Format neu. Klartext-Passwörter haben in einer Importdatei nichts verloren. Unterstützt Shopware das Verfahren des Altsystems nicht, bleibt nur der Weg über eine Passwort-Zurücksetzen-Mail nach dem Livegang.
Jeder Kunde braucht eine Standard-Rechnungs- und eine Standard-Lieferadresse. Bei B2B-Kunden kommen Kundengruppe, Firmenname und Umsatzsteuer-ID dazu. Legen Sie die Kundengruppen vorher an und prüfen Sie, ob Länder und Anreden im Altsystem dieselben Werte haben wie in Shopware.
In Deutschland legen Sie vor dem Produktimport die Steuersätze 19 % und 7 % an und tragen deren IDs in die Produktdatei ein. Für Kundendaten gilt die DSGVO. Wenn eine Agentur oder ein Dienstleister Ihre Importdateien verarbeitet, schließen Sie vorher einen Vertrag zur Auftragsverarbeitung nach Art. 28 DSGVO.
Unabhängig vom Land gilt: Übernehmen Sie nur Kunden, die Sie noch brauchen. Ein Umzug ist eine gute Gelegenheit, inaktive Konten nach Ihren Löschfristen auszusortieren. Importdateien mit Kundendaten gehören nicht in E-Mail-Anhänge oder offene Cloud-Ordner und werden nach dem Import gelöscht. Mehr dazu im Beitrag Datenschutz im Onlineshop.
Für Bestellungen enthält die Shopware-Dokumentation eine Feldreferenz, aber keine Schritt-für-Schritt-Anleitung wie für Produkte oder Varianten. Als Mindestfelder nennt sie id, salesChannelId, orderDateTime und stateId. Dazu kommen Positionen, Adressen, Zahlungs- und Versandstatus, die jeweils an eigenen Tabellen hängen.
Unsere Empfehlung aus Projekten: Übernehmen Sie Bestellhistorie nicht per CSV, wenn es einen anderen Weg gibt.
Wenn Sie den Umzug von einem fremden System planen, lohnt ein Blick auf den Beitrag Von Shopware zu Shopify wechseln. Er zeigt aus der Gegenrichtung, welche Daten beim Plattformwechsel typischerweise verloren gehen.
Wenn Sie einen neuen Shop befüllen, entscheidet die Reihenfolge über den Aufwand. Jeder Schritt braucht IDs aus dem vorherigen. Bewährt hat sich dieser Ablauf:
Der reine Import ist selten das Zeitproblem. Die Arbeit steckt in der Datenaufbereitung. Als grobe Orientierung aus unseren Projekten, ohne Garantie für Ihren Fall:
| Ausgangslage | Aufwand Datenaufbereitung |
|---|---|
| Bis 500 einfache Produkte, saubere Lieferantenliste | 1 bis 2 Arbeitstage |
| 2.000 Produkte mit Varianten und Bildern aus mehreren Quellen | 1 bis 2 Wochen |
| Kompletter Umzug mit Kunden, Varianten und Übersetzungen | Teil eines Migrationsprojekts, Planung in Wochen |
Der größte Zeitfresser ist fast immer die Qualität der Quelldaten: fehlende Artikelnummern, doppelte EAN, Größenangaben mal als M, mal als Medium. Planen Sie eine Bereinigung ein, bevor Sie die erste Datei bauen. Eine Testinstanz, auf der Sie Importe gefahrlos wiederholen können, spart in jedem Projekt Zeit. Zu Versionen und Updates der Testumgebung lesen Sie mehr im Beitrag Shopware Updates und Versionen.
Für wiederkehrende Importe müssen Sie nicht jedes Mal die Administration öffnen. Shopware hat einen Konsolenbefehl import:entity, der laut Befehlsreferenz Entitäten aus einer CSV-Datei importiert. Die genauen Argumente zeigt bin/console import:entity --help auf Ihrer installierten Version. Damit lässt sich zum Beispiel jede Nacht eine Bestandsliste vom Lieferanten einspielen, gesteuert über einen Cronjob auf dem Server.
Zwei Punkte sollten Sie dabei beachten:
messenger:consume, bleiben Folgearbeiten wie Indizierung liegen. Ein sauber eingerichtetes Hosting erledigt das, mehr dazu im Beitrag Shopware Hosting.import-export:delete-expired löscht abgelaufene Import- und Exportdateien. Gerade bei Kundendaten sollten diese nicht dauerhaft auf dem Server liegen.Wenn ein automatischer CSV-Import mehr als eine Datenquelle bedient oder in beide Richtungen laufen soll, ist er meist der Vorläufer einer echten Schnittstelle. Ab diesem Punkt rechnet sich eine Anbindung an Warenwirtschaft oder ERP.
Diese Fehler sehen wir in Projekten am häufigsten. Die meisten lassen sich mit zehn Minuten Vorbereitung vermeiden.
Ein Import schreibt sofort. Ein falsch gemapptes Preisfeld ändert tausende Preise auf einmal, und ein Abbruch macht nichts rückgängig. Testen Sie jede neue Datei zuerst mit dem Testlauf und auf einer Testumgebung. Vor größeren Updates gehört ein Datenbank-Backup dazu.
Wer bei einem Update die ID-Spalte leer lässt und kein zweites Merkmal wie die Artikelnummer gesetzt hat, bekommt neue Produkte statt aktualisierter. Am Ende stehen Dubletten im Shop. Schalten Sie bei reinen Updates das Anlegen neuer Datensätze im Profil ab.
Shopware weist selbst darauf hin, dass die Meldung nach dem Import nicht heißt, dass alles geklappt hat. Prüfen Sie im Protokoll, wie viele Datensätze fehlgeschlagen sind, und laden Sie die Fehlerdatei herunter.
Ein Import fügt hinzu und überschreibt, er löscht nicht. Wenn ein Produkt aus einer Kategorie verschwinden soll, reicht es nicht, die Kategorie in der Datei wegzulassen.
Viele Shops speichern Daten in Erweiterungen, etwa Zusatzfelder für Gefahrgut oder Grundpreise. Ob ein Plugin eigene Import-Profile oder Felder mitbringt, prüfen Sie vorher. Welche Erweiterungen sich bewährt haben, steht im Beitrag Shopware 6 Plugins.
Bei einem Relaunch ändern sich Produkt-URLs. Ohne Weiterleitungen verlieren Sie Rankings und Links. Ein CSV-Import legt zwar neue URLs an, aber keine Weiterleitungen von den alten. Diese brauchen eine eigene Liste.
Nein. Das Modul Import/Export ist in Shopware 6 enthalten. Erweiterungen aus dem Shopware Store bieten zusätzliche Formate wie XML oder Excel, Zeitpläne und komfortablere Zuordnungen. Für die meisten Fälle reicht der Standard.
UTF-8 als Kodierung, Semikolon als Trenner, Anführungszeichen um Texte und Punkt als Dezimalzeichen. Am sichersten starten Sie mit einer Datei, die Sie vorher aus Shopware exportiert haben.
Die Dokumentation enthält eine Feldreferenz für Bestellungen, aber keine Anleitung. Für Umzüge von Shopware 5 oder 6 ist der Migrationsassistent der bessere Weg, für andere Systeme meist ein Import per API.
Ja, wenn Sie den Passwort-Hash und das Verfahren in die Felder legacyPassword und legacyEncoder übernehmen und Shopware dieses Verfahren unterstützt. Sonst setzen Kunden ihr Passwort einmal neu.
Gar nicht. Der Import fügt hinzu oder überschreibt. Löschungen erledigen Sie in der Administration oder per API.
Viele Händler machen ihre Importe selbst, und mit dieser Anleitung ist das für Produkte, Preise und Kundenlisten gut machbar. Wenn Varianten, Übersetzungen, Passwörter und Weiterleitungen zusammenkommen, steigt das Risiko, dass Fehler erst nach dem Livegang auffallen.
Wir unterstützen auf drei Wegen:
Schreiben Sie uns über die Kontaktseite, welche Daten Sie übernehmen wollen und aus welchem System sie kommen. Wir sagen Ihnen ehrlich, ob Sie das gut selbst schaffen.

Besnik Bilalli ist Gründer und CEO von solution25, der Shopware Agentur aus Bremen. Vor der Agenturgründung 2017 hat er selbst einen Online-Shop aufgebaut und auf mehr als 500 Bestellungen am Tag gebracht. Seitdem begleitet er Händler bei Shopware-Projekten, von der ersten Kalkulation bis zum laufenden Betrieb. Fragen zum Artikel beantwortet er gern persönlich: Kontakt aufnehmen.
Verantwortlich für Inhalt und Aktualisierung: Besnik Bilalli. Stand: November 2026. Nächste inhaltliche Prüfung: Februar 2027.