Anleitungen
H001

Shopify CSV „Ungültiger CSV-Header: fehlende Header“: Was ist zu überprüfen?

Überprüfen Sie die erste CSV-Zeile auf die genauen Produktspaltennamen, die Ihr Import benötigt. Ein fehlender Title-Header ist eine häufige Ursache, aber die erforderlichen Spalten hängen davon ab, ob Sie Produkte erstellen, aktualisieren oder Varianten hinzufügen.

Regeldefinition

Die erforderliche Titel-Spalte fehlt.

Kritisch

Grenzen der automatischen Korrektur: Diese Regel erfordert eine manuelle Prüfung; Geschäftsdaten werden nicht automatisch geändert.

Regeldefinition

Ein URL-Handle fehlt, wo ein Update oder Variantenkontext eines erfordert.

KritischWarnung

Grenzen der automatischen Korrektur: Diese Regel erfordert eine manuelle Prüfung; Geschäftsdaten werden nicht automatisch geändert.

Fügen Sie nicht jede Spalte aus einer alten Vorlage ein
Die Fehlerseite von Shopify zeigt eine ältere vollständige Kopfzeile. Das aktuelle CSV-Formathandbuch für das Produkt gibt je nach Importszenario unterschiedliche Mindestspalten an. Beginnen Sie mit Ihrer eigentlichen Datei und dem beabsichtigten Vorgang.

Worauf die Nachricht verweist

Die erste Zeile definiert die Spalten. Eine falsch geschriebene Überschrift, zusätzliche Leerzeichen, ein falsches Trennzeichen oder eine von einem anderen CSV-Typ kopierte Überschrift können dazu führen, dass Shopify die Felder nicht erkennt. Überprüfen Sie die tatsächliche Kopfzeile, bevor Sie Produktdaten ändern.

Welche Header sind erforderlich?

Erstellen Sie ein einfaches Produkt:

Title ist die einzige erforderliche Spalte. Aus dem Titel kann ein fehlendes URL-Handle generiert werden.

Ein vorhandenes Produkt aktualisieren:

Geben Sie sowohl Title als auch URL-Handle an, damit Shopify das Produkt identifizieren kann.

Varianten hinzufügen:

URL-Handle einschließen. Behalten Sie beim Aktualisieren von variantenbezogenen Spalten wie SKU auch die entsprechenden Option1-Namens- und Option1-Wertspalten bei; Das Weglassen abhängiger Optionsdaten kann zu Variantenänderungen führen.

Ein fehlender Title-Header

Dieses minimale Update-Beispiel enthält Produktnamen, aber seine erste Überschrift ist nicht die Title-Spalte von Shopify.

Ungültig: Product-Titel ist nicht Title
Product title,URL handle
Tee,tee

Die Katalogvorprüfung meldet H001 für den fehlenden Title-Header und warnt, dass der Product-Titel unbekannt ist.

Korrigiert: Verwenden Sie die unterstützte Überschrift
Title,URL handle
Tee,tee

Benennen Sie die Spalte nur um, wenn es sich bei ihren Werten tatsächlich um Produkttitel handelt. Bewahren Sie eine Kopie der Originaldatei auf.

So reparieren Sie den Header sicher

  1. 01

    Bestätigen Sie, dass es sich um ein Shopify-Produkt CSV handelt, nicht um ein Inventar oder den Export einer anderen App. Öffnen Sie eine Kopie als durch Kommas getrennten UTF-8-Text.

  2. 02

    Überprüfen Sie die erste Zeile, einschließlich Rechtschreibung und nachgestellte Leerzeichen. Ordnen Sie jede Überschrift den darunter liegenden Daten zu. Benennen Sie nicht zusammenhängende Werte nicht um, nur um einen Fehler zu unterdrücken.

  3. 03

    Wählen Sie „Erstellen“ oder „Aktualisieren“, bevor Sie entscheiden, welche Spalten erforderlich sind. Behalten Sie für Updates und Varianten das Handle und alle abhängigen Optionsspalten bei.

  4. 04

    Speichern Sie ein neues CSV, überprüfen Sie es lokal und überprüfen Sie dann vor dem Import das aktuelle Beispiel und die Importeinstellungen von Shopify.

Überprüfen Sie den Header lokal

Wählen Sie den gewünschten Importmodus in Catalog Precheck. H001 markiert ein fehlendes Title; H002 prüft, wann ein URL-Handle erforderlich ist; H003 warnt vor nicht erkannten Überschriften. Dabei handelt es sich um Dateiprüfungen, nicht um einen simulierten Shopify-Import. Durch die Rückkehr wird ein neuer Validator geöffnet. Die zuvor ausgewählte Datei bleibt nicht erhalten.
Was der Prüfer nicht entscheiden kann
Es kann nicht wissen, ob eine unbekannte Überschrift zu einer gültigen App-Integration gehört, ob eine umbenannte Spalte die richtigen Geschäftsdaten enthält oder was bereits in Ihrem Shop vorhanden ist. Ein sauberer Bericht garantiert keinen Importerfolg.

Geprüfte Quellen: 28. September 2026. Shopify: häufige Importprobleme · Shopify: aktuelles Produkt-CSV-Format

Catalog Precheck ist ein unabhängiges Tool und nicht mit Shopify verbunden.