Brockworks Onlinemarketing – Shopify Produkt-CSV-Update ohne Datenverlust

Shopify · Produktdaten

Shopify Produkt-Update per CSV: Diese Spalten sind wirklich Pflicht

Wie ein minimalistischer CSV-Import bestehende Produkte sicher aktualisiert, ohne Bilder, Varianten oder Beschreibungen versehentlich zu löschen.

Das Wichtigste in Kürze

  • Shopify erkennt bestehende Produkte beim CSV-Import über das Handle, nicht primär über die SKU.
  • Für ein reines Update reicht ein Rumpf-Datensatz aus wenigen Spalten — nicht der komplette 50-Spalten-Export.
  • Der Haken „Replace any current products that have the same handle" muss beim Import aktiv gesetzt werden.
  • Bei Varianten-Produkten müssen alle Varianten in der Datei stehen, sonst gehen fehlende Varianten verloren.
  • Wer Bilder nicht anfassen will, entfernt die Spalten Image Src, Image Alt Text und Variant Image komplett — nicht nur deren Inhalt leeren.

Ein CSV-Update ist im Kern immer dieselbe Aufgabe: Das Shopsystem muss zweifelsfrei erkennen, welcher bestehende Datensatz aktualisiert werden soll — statt versehentlich einen neuen anzulegen oder, schlimmer noch, bestehende Daten mit leeren Werten zu überschreiben. Unabhängig davon, ob Sie mit Shopify, Shopware, WooCommerce oder Magento arbeiten, gilt deshalb ein gemeinsamer Grundsatz: Ohne einen eindeutigen Identifikator pro Zeile schlägt der Import entweder fehl oder erzeugt Duplikate.

Der universelle Standard hinter jedem Produkt-Update

Als Identifikator kommen je nach System drei Varianten infrage: die SKU (Stock Keeping Unit) als klassischer, plattformübergreifender Standard, das Handle bzw. der Slug — also der URL-Bestandteil eines Produkts — oder die interne Datenbank-ID, die das jeweilige System beim ersten Export mitliefert. Welcher dieser drei Wege der richtige ist, entscheidet ausschließlich die Plattform, mit der Sie arbeiten.

Neben dem Identifikator selbst benötigen Sie ausschließlich die Spalten, deren Inhalt Sie tatsächlich ändern möchten. Ein häufiger Denkfehler ist die Annahme, ein Update müsse den kompletten Produktdatensatz enthalten. Tatsächlich reicht es in den meisten Systemen, wenn Sie beispielsweise nur die Preise anpassen wollen, die Kombination aus Identifikator und der Zielspalte — bei einer reinen Preisänderung also SKU beziehungsweise Handle plus Price.

Ziel des UpdatesBenötigte Spalten (Beispiele)
Lagerbestand aktualisierenSKU, Inventory Quantity, Stock Status
PreisanpassungSKU, Price, Compare At Price (UVP)
SEO-OptimierungSKU, Page Title, Meta Description, URL Handle
KategorisierungSKU, Categories, Tags

Darüber hinaus gelten unabhängig vom Shopsystem einige feste Regeln, die über Erfolg oder Fehlschlag eines Uploads entscheiden. Pflichtfelder wie beispielsweise der Produkttitel dürfen in vielen Systemen beim Update nicht leer bleiben, sofern die Plattform leere Zellen nicht explizit als „unverändert lassen" interpretiert — das sollten Sie vor jedem größeren Import in einer Testumgebung oder mit wenigen Testzeilen prüfen. Die Datei selbst sollte immer als UTF-8-kodierte CSV gespeichert werden, da Umlaute wie ä, ö und ü sonst beim Import kryptisch zerschossen werden. Die Spaltenüberschriften müssen zudem exakt den Vorgaben des Systems entsprechen — ein bewährter Weg dafür ist, zunächst ein einzelnes Testprodukt zu exportieren, um die korrekte Vorlage mit den richtigen Header-Namen zu erhalten. Bei Produkten mit Varianten, etwa unterschiedlichen Größen oder Farben, muss zusätzlich zur SKU meist der übergeordnete Identifikator oder das jeweilige Attribut mitgegeben werden, damit das System die Variante korrekt zuordnen kann.

Vor jedem Update: Backup nicht vergessen

Machen Sie grundsätzlich vor jedem Update-Import ein vollständiges Backup Ihrer Produktdaten in Form eines aktuellen Exports. Ein kleiner Fehler in der Identifikator-Spalte — etwa eine verrutschte SKU oder ein falsch geschriebenes Handle — kann sonst im schlimmsten Fall Ihr gesamtes Sortiment überschreiben.

Shopify-Spezifika: Warum das Handle entscheidet

Bei Shopify ist der Import-Mechanismus im Vergleich zu anderen Systemen recht strikt, dafür aber klar nachvollziehbar aufgebaut. Anders als man vielleicht erwarten würde, arbeitet Shopify intern primär mit dem Handle und nicht mit der SKU als Haupt-Identifikator für den Produktabgleich im CSV-Standardtool. Das Handle entspricht dem Teil der Produkt-URL, beispielsweise mein-tolles-produkt in der Adresse ihr-shop.de/products/mein-tolles-produkt. Anhand dieses Handles erkennt Shopify, dass ein Produkt bereits existiert und aktualisiert statt neu angelegt werden soll.

Der entscheidende Haken beim Import

Damit ein Update tatsächlich als solches behandelt wird, müssen Sie beim Import-Dialog zwingend die Option „Replace any current products that have the same handle" aktivieren. Bleibt dieser Haken deaktiviert, ignoriert Shopify die betreffenden Zeilen entweder komplett oder meldet einen Fehler, dass das Handle bereits vergeben sei.

Sobald ein Produkt Varianten besitzt — etwa unterschiedliche Größen oder Farben —, reicht das Handle allein nicht mehr aus, um die richtige Zeile in der CSV korrekt zuzuordnen. Hier kommen zusätzlich Option1 Name und Option1 Value ins Spiel, beispielsweise Color und Red. Die SKU wiederum wird von Shopify zwar nicht als primärer Identifikator für das Produkt-Matching im Standard-CSV-Tool genutzt, ist aber essenziell für den Abgleich mit angebundenen Warenwirtschaftssystemen und sollte deshalb aus Sicherheitsgründen trotzdem in jeder Import-Zeile mitgeführt werden.

Typische Update-Szenarien und ihre Pflichtspalten

Ein weit verbreitetes Missverständnis ist die Annahme, für ein Shopify-Update müssten alle über fünfzig verfügbaren Spalten des Standard-Exports befüllt sein. Tatsächlich reicht in der Praxis ein deutlich schlankerer „Rumpf-Datensatz", der sich exakt an dem orientiert, was tatsächlich geändert werden soll.

Szenario A — nur Preise oder Lagerbestand ändern:

SpalteGrund
HandleIdentifiziert das zu aktualisierende Produkt eindeutig
Variant SKUEmpfohlen zur zusätzlichen Absicherung bei Varianten-Produkten
Variant PriceEnthält den neuen Verkaufspreis
Variant Inventory QtyNur relevant, wenn Shopify selbst den Lagerbestand verwaltet — dafür muss die Spalte Variant Inventory Tracker auf „shopify" stehen

Szenario B — SEO-Texte oder Produkttitel ändern:

SpalteGrund
HandleIdentifiziert das Produkt
TitleDer neue Produktname
Body (HTML)Die neue Produktbeschreibung
SEO Title / SEO DescriptionDie Meta-Angaben, die Google in den Suchergebnissen anzeigt

Diese schlanke Herangehensweise reduziert nicht nur das Fehlerrisiko, sondern beschleunigt auch spürbar die Bearbeitung großer Kataloge, weil Sie nicht bei jedem Update den kompletten Datensatz eines Produkts mitschleppen müssen.

Wichtige Fallstricke bei Shopify-Importen

Neben der grundsätzlichen Spaltenlogik gibt es bei Shopify einige Besonderheiten, die in der Praxis regelmäßig zu unerwartetem Datenverlust führen, wenn man sie nicht kennt.

Die „Alles oder Nichts"-Falle

  • Steht ein Handle in der CSV, erwartet Shopify meist alle zugehörigen Varianten in derselben Datei
  • Fehlt bei einem Drei-Farben-Produkt eine Farbe in der Upload-Datei und ist „Replace" aktiv, werden die fehlenden Varianten häufig gelöscht
  • Betrifft besonders unvollständige Exporte aus Drittsystemen

So vermeiden Sie den Datenverlust

  • Vor dem Import immer alle Varianten eines Handles vollständig in der Datei prüfen
  • Bei Teilaktualisierungen auf spezialisierte Tools statt des Standard-CSV-Imports setzen
  • Testimporte mit wenigen Zeilen vor dem Massen-Update durchführen

Auch das Encoding bleibt ein Dauerbrenner: Shopify verlangt zwingend UTF-8-kodierte Dateien. Wer seine CSV in Excel bearbeitet, sollte explizit die Option „CSV UTF-8 (durch Komma getrennt)" beim Speichern wählen — die Standard-CSV-Option von Excel führt bei deutschen Umlauten zuverlässig zu zerschossenen Zeichen im Shop-Frontend.

Für regelmäßige Massen-Updates empfiehlt sich statt des Bordmittel-CSV-Tools eine spezialisierte App wie Matrixify. Das native Shopify-Import-Tool eignet sich gut für kleine, überschaubare Änderungen, stößt bei komplexeren Teilaktualisierungen aber an Grenzen. Matrixify erlaubt es dagegen, wirklich nur die zwei oder drei relevanten Spalten — etwa Handle und Price — hochzuladen, ohne den Rest eines Produkts unbeabsichtigt zu gefährden.

Bilder schützen: Welche Spalten Sie löschen müssen

Ein besonders sensibler Punkt ist der Umgang mit Produktbildern beim Update. Das Standard-Verhalten von Shopify ist hier eindeutig: Importieren Sie ein Produkt mit demselben Handle und ist der Haken „Replace any current products that have the same handle" gesetzt, wird das Produkt im Prinzip vollständig überschrieben — inklusive aller Bilddaten, sofern die entsprechenden Spalten in der Datei vorhanden sind.

Damit Ihre bestehenden Produktfotos beim Update sicher unangetastet bleiben, müssen folgende Spalten komplett aus der CSV-Datei entfernt werden — gemeint ist die gesamte Spalte, nicht nur der Zelleninhalt:

  • Image Src — die wichtigste Spalte; fehlt sie komplett, lässt Shopify vorhandene Bilder unverändert
  • Image Command — falls vorhanden, meist nur bei Anbindungen über Drittanbieter-Apps relevant
  • Image Alt Text — ohne Image Src fehlt dieser Spalte ohnehin der Bezugspunkt
  • Variant Image — entscheidend, wenn einzelnen Varianten wie Farben eigene Bilder zugeordnet sind

Spalte löschen statt Zelle leeren — der feine, aber entscheidende Unterschied

Eine leere Zelle kann von Shopify je nach Import-Konstellation als aktive Anweisung „lösche den bestehenden Wert" interpretiert werden. Fehlt die Spalte dagegen komplett in der Datei, erhält Shopify dazu gar keine Anweisung und lässt die vorhandenen Bilder unangetastet. Dieser Unterschied zwischen einer leeren Zelle und einer fehlenden Spalte ist bei Shopify-Importen einer der häufigsten Gründe für unbeabsichtigten Bildverlust.

Der sichere Workflow für Updates ohne Datenverlust

Wenn Sie ausschließlich Preise, Lagerbestände oder Beschreibungstexte ändern möchten, sollte Ihre CSV so schlank wie möglich aufgebaut sein. Der folgende Ablauf hat sich in der Praxis bewährt:

  1. Testprodukt exportieren: Ein einzelnes Produkt aus Shopify exportieren, um die exakten, aktuell gültigen Spaltennamen als Vorlage zu erhalten.
  2. Datei auf das Nötigste reduzieren: Nur Handle, optional Title sowie die konkret zu ändernde Spalte (z. B. Variant Price oder Body (HTML)) behalten.
  3. Bild-Spalten vollständig entfernen: Image Src, Image Alt Text, Image Command und Variant Image aus der Datei löschen, wenn Bilder unangetastet bleiben sollen.
  4. Backup ziehen: Vor dem eigentlichen Upload einen vollständigen Produktexport als Sicherung anlegen.
  5. Testlauf mit wenigen Zeilen: Erst eine kleine Stichprobe von zwei bis drei Produkten importieren und im Frontend kontrollieren.
  6. Vollimport mit aktivem „Replace"-Haken: Nach erfolgreicher Stichprobe den vollständigen Import mit gesetztem Replace-Häkchen durchführen.

Wer diesen Ablauf konsequent einhält, reduziert das Risiko unerwarteter Datenverluste beim CSV-Update erheblich — unabhängig davon, ob es sich um zehn oder mehrere tausend Produkte handelt. Bei größeren, wiederkehrenden Importprozessen lohnt sich zusätzlich der Einsatz von Matrixify oder eine feste Importlogik über Shopify Flow, damit die richtige Spaltenauswahl nicht bei jedem Update erneut manuell zusammengestellt werden muss.

Wenn Sie Ihren Produktkatalog technisch sauber strukturieren, wiederkehrende CSV-Prozesse automatisieren oder einen bestehenden Import-Workflow überprüfen lassen möchten, unterstützen wir Sie im Rahmen unserer Shopify-Shopentwicklung — von der ersten Spaltenlogik bis zur fehlerfreien Massenaktualisierung.

Brockworks Logo

Brockworks OnlinemarketingSEO, Shopentwicklung und Onlinemarketing aus Witten, NRW. Wir betreuen Shopify-Shops von der technischen Basis bis zur Kampagne.

Jetzt kostenlos &
unverbindlich anfragen

Google Bewertungen zu Brockworks:

Mit dem Absenden des Kontaktformulars bestätigen Sie die Verarbeitung Ihrer Daten und stimmen der Datenschutzerklärung zu.

FAQ

Häufige Fragen

Erkennt Shopify Produkte beim CSV-Import über die SKU oder über das Handle?

Primär über das Handle, also den URL-Bestandteil des Produkts. Die SKU wird zwar mitgeführt und ist für den Abgleich mit Warenwirtschaftssystemen wichtig, dient im Standard-CSV-Tool aber nicht als Haupt-Identifikator für das Produkt-Matching.

Muss ich beim Update wirklich alle Spalten aus dem Vollexport ausfüllen?

Nein. Für ein reines Update reicht ein Rumpf-Datensatz aus Handle und der konkret zu ändernden Spalte, zum Beispiel Variant Price oder Body (HTML). Alle anderen Spalten können weggelassen werden.

Was passiert, wenn ich bei einem Varianten-Produkt nicht alle Varianten in der CSV habe?

Ist der Replace-Haken aktiv, kann Shopify die in der Datei fehlenden Varianten löschen, weil es die Zeile als vollständigen Ersatz des Produkts interpretiert. Deshalb sollten bei Varianten-Produkten immer alle Varianten in der Import-Datei enthalten sein.

Wie verhindere ich, dass meine Produktbilder beim Update gelöscht werden?

Entfernen Sie die Spalten Image Src, Image Alt Text, Image Command und Variant Image komplett aus der CSV-Datei, statt nur deren Zellinhalte zu leeren. Fehlt eine Spalte ganz, lässt Shopify die zugehörigen Bilddaten unverändert.

Warum sollte ich Matrixify statt des Shopify-Standard-Imports nutzen?

Matrixify erlaubt es, gezielt nur die tatsächlich zu ändernden Spalten hochzuladen, ohne den restlichen Produktdatensatz zu gefährden. Für kleine, gelegentliche Änderungen reicht das Bordmittel-Tool von Shopify meist aus.

Produktdaten-Import sicher aufsetzen?

Wir strukturieren Ihre CSV-Prozesse für Shopify so, dass Preise, Lagerbestände und Texte aktualisiert werden – ohne Bild- oder Variantenverlust.