Ein nicht funktionierender WooCommerce-Produktimport ist fast immer ein Problem mit der CSV-Datei und nicht mit Ihrem Shop. Kodierung, nicht zugeordnete Spalten, eine fehlerhafte übergeordnete Verknüpfung bei Variationszeilen oder eine Serverbeschränkung sind für die große Mehrheit der Fehler verantwortlich, und jeder einzelne hat eine spezifische Behebung, die Sie in wenigen Minuten überprüfen können.
Das Frustrierende daran ist, wie leise es fehlschlägt. WooCommerce meldet oft einen erfolgreichen Import, während die Hälfte Ihrer Zeilen nirgendwo hingekommen ist, sodass Sie raten müssen, welche Stufe kaputt gegangen ist.
Diese Anleitung führt Sie durch die Ursachen in der Reihenfolge, in der sie am besten zu überprüfen sind, von der Datei selbst über Plugin-Konflikte bis hin zu Serverlimits, mit der genauen Lösung für jede einzelne. Fangen wir also an!
Inhaltsverzeichnis
CSV-Formatprobleme: Die häufigste Ursache
Ein Großteil der Fälle von „Import funktioniert nicht“ liegt an der Datei, nicht am Shop. Drei Details verursachen die meisten stillen Fehler, und alle drei sind sichtbar, wenn Sie die CSV in einem einfachen Texteditor und nicht in einer Tabellenkalkulationsanwendung öffnen.
- UTF-8-Kodierung: von Excel gespeicherte Dateien verwenden standardmäßig Windows-1252 oder MacRoman, und jedes Akzentzeichen, Währungssymbol oder jede intelligente Anführungszeichen wird beschädigt. Speichern Sie als „CSV UTF-8 (Kommagetrennt)“ neu oder verwenden Sie Google Tabellen, das standardmäßig UTF-8 exportiert.
- Nicht in Anführungszeichen gesetzte Felder mit mehreren Werten: eine Zelle, die mehrere Kategorien oder Bild-URLs enthält, muss in doppelte Anführungszeichen gesetzt werden. Ohne sie wird das Komma als Spaltentrenner gelesen und die Zeile zerfällt.
- Variantenzeilen ohne übergeordnetes Element: jede Variante benötigt eine Spalte „Parent“ (Übergeordnetes Element), die die SKU des übergeordneten Produkts enthält. Fehlende oder falsche Werte bedeuten, dass Varianten als verwaiste einfache Produkte importiert werden.
Führen Sie diese Checkliste für die Datei durch, bevor Sie annehmen, dass das Problem auf der WooCommerce-Seite liegt:
- Öffnen Sie sie in einem einfachen Texteditor und suchen Sie nach fehlerhaften Zeichen. „café“ als „café“ anzuzeigen, bestätigt ein Kodierungsproblem.
- Prüfen Sie, ob Zellen mit mehreren Werten in doppelte Anführungszeichen eingeschlossen sind.
- Stellen Sie bei variablen Produkten sicher, dass einige Variantenzeilen auf die korrekte übergeordnete SKU verweisen, ohne nachgestellte Leerzeichen.
- Importieren Sie zuerst 5 bis 10 Zeilen. Wenn diese korrekt landen, skalieren Sie auf die vollständige Datei hoch.
Die vollständige Aufschlüsselung der Spalten, akzeptierten Werte und Formatierungsregeln finden Sie in unserem WooCommerce CSV-Importleitfaden.
Warum funktioniert Ihr WooCommerce-Produktimport nicht?
Ein nicht funktionierender WooCommerce-Produktimport beruht auf vier Ursachen: der Formatierung der Datei, nicht zugeordneten Spalten, einem Plugin, das die Produktdatenerstellung beeinträchtigt, oder dem Server, der den Prozess abkürzt. Die Überprüfung in dieser Reihenfolge findet die Ursache am schnellsten, da die ersten beiden weitaus häufiger vorkommen als die letzten beiden.
- Falsche Kodierung oder nicht in Anführungszeichen gesetzte Werte, die Kommas enthalten
- Spalten, die während der Zuordnung auf „Nicht importieren“ belassen werden
- Variantenzeilen, die nicht auf ihr übergeordnetes Element verweisen
- Timeouts oder Speichererschöpfung bei großen Dateien
- Konflikte mit Caching-, Sicherheits- oder SEO-Plugins
- Bild-URLs, die der Server nicht erreichen kann
Beginnen Sie mit der Datei. Überprüfen Sie die Formatierung und bestätigen Sie Ihre Zuordnung, bevor Sie sich bei Bedarf den Plugin- und Serverprüfungen zuwenden.
Welches Dateiformat wird für WooCommerce-Produktimporte benötigt?
WooCommerce importiert CSV-Dateien in UTF-8-Kodierung und nichts anderes. Andere Formate wie XLSX, TSV oder JSON müssen zuerst in CSV konvertiert werden, was jede Tabellenkalkulationsanwendung über "Speichern unter" oder "Herunterladen" erledigt.
Wissenswert: Weitaus weniger Spalten sind erforderlich, als die meisten Anleitungen behaupten. Nur Name ist wirklich zwingend erforderlich, plus Type für alles, was kein einfaches Produkt ist. Die SKU wird automatisch generiert, wenn sie fehlt. Eine leere SKU-Spalte stoppt einen Import also nicht, obwohl Sie dann keinen Schlüssel für zukünftige Aktualisierungen haben.
- Hat jede Zeile einen Namen?
- Sind die Produkttypen korrekt geschrieben (
simple,variable,variation)? - Gibt es nachgestellte Leerzeichen oder versteckte Zeichen in den Spalten SKU oder Parent?
- Gibt es komplett leere Zeilen, die in die Daten gemischt sind?
Warum Spalten auf dem Mapping-Bildschirm fehlen
Wenn Produkte importiert wurden, aber ihre Daten leer sind, wurde die Spalte mit ziemlicher Sicherheit auf "Nicht importieren" belassen. WooCommerce zeigt nach dem Hochladen einen Bildschirm zur Spaltenzuordnung an, und alles, was es nicht erkennt, wird standardmäßig übersprungen, anstatt erraten zu werden.
Das bedeutet auch, dass Ihre Header nie mit den Namen von WooCommerce übereinstimmen mussten. Eine Spalte namens "Artikelcode" oder "Produkt-SKU" lässt sich perfekt aus der Dropdown-Liste zuordnen, sodass das Umbenennen der Spalten Ihres Lieferanten verschwendete Mühe ist. Lesen Sie den Zuordnungsbildschirm, anstatt ihn zu übergehen, und wählen Sie jede Spalte aus, die Sie tatsächlich benötigen.
Nicht erkannte Spalten können auch einem benutzerdefinierten Feld zugeordnet werden, indem sie einem meta:-Schlüssel zugeordnet werden. So werden Lieferantencodes und Großhandelspreise übertragen.
Welche Plugin-Konflikte beeinträchtigen den WooCommerce-Produktimport?
Plugins, die sich in die Produkt-Erstellung einklinken, können einen Import verlangsamen oder Zeilen komplett ablehnen. Caching-, Sicherheits- und SEO-Tools sind die üblichen Verdächtigen, da sie jedes Mal, wenn ein Produkt gespeichert wird, zusätzliche Arbeit leisten.
- Caching-Plugins (WP Rocket, W3 Total Cache)
- Sicherheits- und Firewall-Plugins (Wordfence)
- SEO-Tools, die sich in Produktdaten einhängen
- Andere Import- und Export-Tools
Testen Sie auf einer Staging-Website mit deaktivierten, nicht essenziellen Plugins und einem Standard-Theme wie Twenty Twenty-Four. Wenn der Import reibungslos läuft, aktivieren Sie ein Plugin nach dem anderen wieder, bis er erneut fehlschlägt.
Wie prüft man Serverressourcenlimits für Produktimporte?
Große Kataloge können die Ausführungszeit oder den Speicher von PHP überschreiten, bevor der Import abgeschlossen ist. In diesem Fall stoppt der Prozess ohne aussagekräftige Fehlermeldung. Das PHP-Handbuch gibt die Standardeinstellung max_execution_time mit 30 Sekunden über einen Webserver an, was bei einigen tausend Zeilen problemlos überschritten wird.
max_execution_time, erhöht auf 300 Sekunden oder mehr für große Dateienmemory_limit, wobei 512 MB ein vernünftiger Ausgangspunkt sindupload_max_filesizeundpost_max_size, die begrenzen, was Sie über den Browser hochladen können
Diese befinden sich in Ihrer PHP-Konfiguration, und Shared Hosting schränkt oft ein, was Sie ändern dürfen. Die zuverlässige Umgehungslösung sind kleinere Stapel von 500 bis 1.000 Zeilen, die die Limits vollständig umgehen.
Welche Fehlermeldungen erscheinen, wenn ein Import fehlschlägt?
WooCommerce meldet Fehler auf Zeilenebene, anstatt sie zu erklären. Die Importzusammenfassung zeigt Ihnen, wie viele Zeilen importiert, aktualisiert, übersprungen und fehlgeschlagen sind. Die Anzahl der fehlgeschlagenen Zeilen ist die Zahl, die es wert ist, gelesen zu werden, da ein „erfolgreicher“ Import immer noch die Hälfte Ihrer Datei übersprungen haben kann.
Eine blockierte Fortschrittsanzeige ohne jegliche Zusammenfassung bedeutet normalerweise ein Timeout und kein Datenproblem. Wenn nichts auf dem Bildschirm erscheint, überprüfen Sie das Fehlerprotokoll Ihres Servers und stellen Sie sicher, dass WordPress und WooCommerce beide auf dem neuesten Stand sind.
Wie verhindert man doppelte oder fehlende Produkte?
Duplikate bedeuten fast immer, dass das Kontrollkästchen Bestehende Produkte aktualisieren nicht aktiviert war. Wenn es aktiviert ist, gleicht WooCommerce jede Zeile anhand der Produkt-ID oder SKU mit Ihrem Katalog ab und aktualisiert die Übereinstimmung, anstatt eine zweite Kopie zu erstellen. Zeilen ohne Übereinstimmung werden übersprungen, anstatt hinzugefügt zu werden.
Das gegenteilige Symptom, Produkte, die stillschweigend übersprungen wurden, obwohl Sie Updates erwartet haben, bedeutet, dass das Kontrollkästchen aktiviert war, aber nichts übereinstimmte. Überprüfen Sie die SKU-Spalte auf nachgestellte Leerzeichen und inkonsistente Groß-/Kleinschreibung, beides üblich in Lieferantendateien und beides ausreichend, um eine Übereinstimmung zu verhindern.
- Verwenden Sie eindeutige SKUs für Produkte und Variationen
- Lassen Sie die ID-Spalte weg, es sei denn, Sie aktualisieren gezielt nach ID
- Fügen Sie nur die Spalten hinzu, die Sie bei einem Update ändern möchten
- Sichern Sie alles vor jedem Update, da es sofort auf Ihren Live-Katalog angewendet wird
Was tun, wenn der Import immer noch nicht läuft
Wenn die Datei sauber ist und Ihr WooCommerce-Produktimport weiterhin nicht funktioniert, liegt das Problem fast immer an der Größe. Drei Ansätze umgehen dies, ohne Ihren Hosting-Plan zu ändern.
- Verwenden Sie einen Server-Dateipfad. Laden Sie die CSV-Datei per FTP hoch, öffnen Sie dann Erweiterte Optionen auf dem Importbildschirm und geben Sie den Pfad ein. Das Limit für den Browser-Upload gilt dann überhaupt nicht mehr.
- Teilen Sie die Datei auf. Stapel von 500 bis 1.000 Zeilen werden gut innerhalb jedes Timeouts abgeschlossen, und ein Fehler kostet Sie nur einen Stapel.
- Führen Sie es über die Befehlszeile aus. WP-CLI umgeht Browser- und Webserver-Timeouts, was sich gut für sehr große einmalige Migrationen eignet.
Testen Sie den gesamten Prozess zuerst auf einer Staging-Website, wenn der Katalog groß ist. Ein Import, der auf einem Live-Shop halb fertiggestellt wird, ist erheblich mehr Arbeit, um ihn zu korrigieren, als einer, der sicher woanders fehlschlägt.
Wie kann man Produkte zur Fehlerbehebung exportieren?
Der Export Ihrer vorhandenen Produkte liefert Ihnen eine Datei, die WooCommerce bereits akzeptiert, wodurch das Rätselraten durch Vergleiche ersetzt wird. Legen Sie Ihren Export neben Ihre Importdatei, und der Fehler wird normalerweise offensichtlich: eine anders benannte Spalte, ein Wert in der falschen Form, eine fehlende Elternreferenz.
Store Exporter Deluxe kümmert sich um den Export, in CSV, TSV, XLS, XLSX, XML oder JSON:
- Produkte, Variationen, Tags und Lagerbestände exportieren
- Fehlende Taxonomiebegriffe oder benutzerdefinierte Felder finden
- Erstellen Sie eine Arbeitsvorlage, aus der Sie Ihre Importdatei erstellen können
- Archivieren Sie einen Snapshot vor jeder größeren Änderung
Was sind die Best Practices, um Importfehler zu vermeiden?
Einige Gewohnheiten verhindern die meisten wiederkehrenden Probleme. Sie kosten anfangs etwas Zeit und sparen die Nacharbeit, die entsteht, wenn zwei Wochen später ein fehlerhafter Import entdeckt wird.
- Sichern Sie Ihren Shop vor jedem großen Import
- Testen Sie jedes Mal zuerst mit einer kleinen Beispieldatei
- Speichern Sie als CSV UTF-8 anstelle von einfachem CSV
- Halten Sie WordPress und WooCommerce auf dem neuesten Stand
- Verwenden Sie eine Staging-Site für Massenvorgänge
- Stichprobenartige Überprüfung einer Handvoll Produkte danach, anstatt sich auf die Zusammenfassung zu verlassen
Abschließende Gedanken
Ein nicht funktionierender WooCommerce-Produktimport bedeutet selten einen defekten Shop. Es ist eine Datei, die nicht ganz das aussagt, was Sie denken, und die Lösung ist normalerweise eine Einstellung oder eine Spalte entfernt.
Hier ist eine kurze Zusammenfassung dessen, was in der Reihenfolge zu überprüfen ist:
- Dateikodierung und Anführungszeichen, die mit Abstand häufigste Ursache.
- Der Bildschirm Spaltenzuordnung, wo Daten leise verloren gehen.
- Plugin-Konflikte, getestet auf Staging mit einem Standard-Theme.
- Serverlimits oder einfach kleinere Stapel.
- Das Kontrollkästchen Vorhandene Produkte aktualisieren, das Duplikate entscheidet.
Wenn Sie eine Datei beheben, die Sie nicht erstellt haben, beginnen Sie mit einer, die WooCommerce bereits akzeptiert. Exportieren Sie Ihren aktuellen Katalog mit Store Exporter Deluxe und vergleichen Sie ihn mit der fehlerhaften Datei.
Häufig gestellte Fragen
Was bedeuten „CSV-Formatierungsanforderungen“ für den WooCommerce-Import?
Es bedeutet eine kommagetrennte Datei, die in UTF-8 mit einer Kopfzeile gespeichert wurde. Nur die Spalte Name ist wirklich erforderlich, und Ihre Kopfzeilen müssen nicht mit den Feldnamen von WooCommerce übereinstimmen, da der Bildschirm Spaltenzuordnung es Ihnen ermöglicht, jede einzelne zuzuweisen. Die vollständige Spezifikation finden Sie in unserem CSV-Importleitfaden.
Warum ist mein WooCommerce CSV-Import erfolgreich, aber die Produkte erscheinen nicht?
Drei Ursachen sind für fast alle diese Fälle verantwortlich. Die Produkte wurden als Entwürfe importiert, überprüfen Sie also den Statusfilter in der Produktliste. Eine Spalte „Veröffentlicht“ wurde auf 0 oder -1 gesetzt, was sie privat oder zum Entwurf macht. Oder ein übergeordnetes variables Produkt wurde importiert, während seine Variationen fehlschlugen, was sich als Produkt ohne kaufbare Optionen zeigt.
Warum funktioniert mein WooCommerce-Produktimport nicht?
Die häufigsten Gründe sind eine Datei, die in der falschen Kodierung gespeichert wurde, Spalten, die während der Zuordnung auf „Nicht importieren“ gesetzt wurden, Variationszeilen ohne übergeordneten Wert und Server-Timeouts bei großen Dateien. Überprüfen Sie diese in dieser Reihenfolge, da die ersten beiden die meisten Fehler verursachen und beide sichtbar sind, bevor Sie den Import ausführen.
Wie behebe ich „404 Bild-URL“-Fehler beim CSV-Import?
Der Importeur lädt jede Bild-URL während des Imports herunter, daher muss jede URL ein echtes Bild ohne Weiterleitung oder Login-Wand zurückgeben. Testen Sie sie mit curl -I oder fügen Sie eine in ein Inkognito-Fenster ein. Bilder hinter Authentifizierung oder Hotlink-Schutz schlagen immer fehl. Laden Sie diese daher zuerst in Ihre Mediathek hoch und verweisen Sie auf ihre endgültigen URLs.
Warum wurden meine Variationen als separate Produkte importiert?
Die Spalte „Parent“ fehlt, ist falsch geschrieben oder stimmt nicht exakt mit der SKU des übergeordneten Elements überein. Jede Variationszeile benötigt den Typ auf variation gesetzt und einen übergeordneten Wert, der die SKU des übergeordneten Elements oder id: plus seine Produkt-ID enthält. Abschließende Leerzeichen sind der übliche Schuldige, da sie in einer Tabelle unsichtbar sind, aber die Übereinstimmung brechen.
Warum stoppt mein Import auf halbem Weg?
Das ist ein Timeout, kein Datenproblem. PHP stoppt jedes Skript, das länger als max_execution_time läuft, was auf den meisten Servern standardmäßig 30 Sekunden beträgt. Teilen Sie die Datei in Stapel von 500 bis 1.000 Zeilen auf oder legen Sie sie auf dem Server ab und verwenden Sie die Option Dateipfad unter Erweiterte Optionen.
Kann ich einen WooCommerce-Produktimport rückgängig machen?
Nein, WooCommerce hat kein Rückgängig für Importe, weshalb ein Backup vor jedem großen Lauf wichtig ist. Um einen fehlerhaften Import zu korrigieren, korrigieren Sie die Quelldatei und führen Sie sie erneut aus, wobei Sie "Bestehende Produkte aktualisieren" ankreuzen, damit die Zeilen an Ort und Stelle korrigiert und nicht dupliziert werden.
