„Invalid CSV header: missing headers“ beim Shopify-Produktimport beheben

Was dieser Fehler bedeutet

Die erste Zeile einer Produkt-CSV ist die Kopfzeile, und Shopify ordnet die Spalten anhand ihrer exakten Namen zu. Fehlt eine Pflichtspalte wie Title oder URL handle (in älteren Vorlagen Handle) oder weicht ihre Schreibweise ab, kann Shopify die Datei nicht lesen und bricht den Import ab.

Häufige Ursachen

• Die Datei stammt von einer anderen Plattform mit eigenen Spaltennamen, etwa Name statt Title.
• Eine Pflichtspalte wurde beim Bearbeiten der Datei gelöscht.
• Ein Spaltenkopf enthält ein überzähliges Leerzeichen, einen Tippfehler oder eine andere Formulierung als in der Shopify-Vorlage.

So wird es behoben

1. Laden Sie die Shopify-Beispiel-Produkt-CSV herunter oder exportieren Sie ein Produkt aus Ihrem Shop, um die korrekten Kopfzeilen zu sehen.
2. Vergleichen Sie die erste Zeile Ihrer Datei Spalte für Spalte mit der Beispiel-CSV.
3. Benennen Sie jede Spalte um, deren Name nicht exakt übereinstimmt, und ergänzen Sie fehlende Pflichtspalten.
4. Entfernen Sie Leerzeichen am Anfang oder Ende jedes Spaltenkopfs.
5. Speichern Sie die Datei als CSV UTF-8 und importieren Sie sie erneut.

Beispiel

Handle,Name,Price
wool-scarf,Wool scarf,24.90

URL handle,Title,Price
wool-scarf,Wool scarf,24.90

Name ist keine Shopify-Spalte. Wird er zu Title umbenannt und Handle zu URL handle, entspricht die Datei der aktuellen Vorlage.

So vermeiden Sie es

• Beginnen Sie neue Dateien mit der Shopify-Vorlage oder einem frischen Export, statt Kopfzeilen von Hand zu bauen.
• Verwenden Sie einen Validator, der jeden Spaltenkopf mit den aktuellen und den älteren Spaltennamen von Shopify vergleicht.

Häufig gestellte Fragen

Kann ich ältere Spaltennamen wie Variant Price verwenden?

Shopify akzeptiert weiterhin Dateien in der älteren Vorlage, halten Sie aber alle Spalten in einem Format. Mischen Sie alte und neue Namen in einer Datei, können Spalten falsch zugeordnet werden.

Was ist das Fenster „Choose column headings“?

Shopify zeigt es an, wenn Ihre Kopfzeilen nicht übereinstimmen. Dort können Sie jede Spalte zuordnen, doch das Korrigieren der Kopfzeilen in der Datei ist für künftige Importe zuverlässiger.

Passende Prüfungen in Skuvera

• Spalte „Title“ fehlt
• Spalte „URL handle“ fehlt
• Unbekannte Spalte

Weitere Importfehler

• „Validation failed: price can't be blank“ bei einem Shopify-CSV-Import beheben
• „Validation failed: options are not unique“ bei einem Shopify-CSV-Import beheben
• „Ignored line because handle already exists“ bei einem Shopify-CSV-Import beheben
• „Ignored line because it did not contain product data“ bei einem Shopify-CSV-Import beheben
• „Network error: Unexpected token < in JSON at position 0“ bei einem Shopify-CSV-Import beheben
• Shopify-CSV-Importfehler