„WooCommerce UPC, EAN, and ISBN“ stillgelegt

Diese Seite handelt von zwei Plugins, die WooCommerce um ein GTIN-Feld ergänzt haben, als WooCommerce selbst noch keines hatte: WooCommerce UPC, EAN, and ISBN und Product GTIN (EAN, UPC, ISBN) for WooCommerce. Wenn Ihr Shop eines davon genutzt hat, stehen Ihre Codes noch im Feld dieses Plugins, aber WooCommerce verwendet heute ein eigenes Feld.

Was mit den beiden Plugins passiert ist

WooCommerce UPC, EAN, and ISBN, letzte Version 0.5.1: am 23. Oktober 2025 auf Wunsch des Autors stillgelegt. Auf der Seite des Plugins im Verzeichnis steht: „Diese Stilllegung ist dauerhaft.“ Die Codes liegen in hwp_product_gtin bei Produkten und in hwp_var_gtin bei Varianten.
Product GTIN (EAN, UPC, ISBN) for WooCommerce, letzte Version 1.1.1: am 5. Januar 2023 stillgelegt. Als Grund nennt die Seite des Plugins im Verzeichnis „Sicherheitsproblem“. Die Codes liegen in _wpm_gtin_code, bei Produkten und bei Varianten.

Ein stillgelegtes Plugin lässt sich bei WordPress.org weder herunterladen noch aktualisieren. Eine bereits installierte Kopie läuft weiter wie bisher. Die Codes bleiben sogar erhalten, wenn Sie das Plugin löschen: Keines der beiden entfernt seine Daten bei der Deinstallation (das haben wir im Quellcode geprüft).

Product GTIN for WooCommerce wurde laut WordPress.org wegen eines Sicherheitsproblems stillgelegt und seitdem nicht mehr aktualisiert. Ist es in Ihrem Shop noch aktiv, deaktivieren Sie es jetzt. Für alles, was unten steht, brauchen Sie es nicht: Die Codes bleiben in der Datenbank, und der Export von WooCommerce liest sie auch ohne das Plugin.

Diese Website gehört zu Merchlint, einem eigenständigen Plugin, das den Produktkatalog prüft. Merchlint steht in keiner Verbindung zu den beiden Plugins oder ihren Autoren. Die Namen der Plugins stehen hier nur, damit klar ist, in welchem Feld Ihre Codes liegen. Merchlint ist auch kein Ersatz für diese Plugins: Das GTIN-Feld, das sie nachgerüstet haben, gehört heute zu WooCommerce selbst.

Wo WooCommerce den Code heute erwartet

Seit Version 9.2 hat WooCommerce ein eigenes Feld. Öffnen Sie ein Produkt und gehen Sie zu Produktdaten → Lagerbestand: Unter der Artikelnummer steht das Feld GTIN, UPC, EAN oder ISBN. Jede Variante hat dasselbe Feld im Tab Varianten. WooCommerce speichert den Code als _global_unique_id. In der CSV-Datei für Produkte heißt die Spalte „GTIN, UPC, EAN oder ISBN“. Seit Version 9.3 schreibt WooCommerce den Code außerdem für Google in die strukturierten Daten der Produktseite. Mehr zu diesem Feld: Produkt ohne GTIN.

WooCommerce kennt die Felder der alten Plugins nicht. Die Codes aus diesen Feldern erscheinen deshalb weder im Feld von WooCommerce noch in der GTIN-Spalte des Exports noch in den strukturierten Daten, die WooCommerce für Google ausgibt. Solange ein altes Plugin aktiv ist, schreibt es seinen Code selbst in die strukturierten Daten der Produktseite (mehr dazu unter Nach dem Übertragen). Ohne das Plugin erreicht der Code Google nur noch über ein Feed-Plugin, das auf das alte Feld eingestellt ist.

Wie viele Codes noch in den alten Feldern stehen, zeigt WP-CLI:

wp db query "SELECT meta_key, COUNT(*) FROM wp_postmeta \
  WHERE meta_key IN ('hwp_product_gtin','hwp_var_gtin','_wpm_gtin_code') \
  AND TRIM(meta_value) <> '' GROUP BY meta_key"

Ersetzen Sie wp_ durch das Tabellenpräfix Ihres Shops.

Was WooCommerce annimmt und was nicht

Die alten Plugins haben jeden Code so gespeichert, wie er eingetippt wurde. Das Feld von WooCommerce prüft eine Sache, eine andere nicht. Beides haben wir am 19. Oktober 2026 mit WooCommerce 11.2.1 geprüft:

WooCommerce lehnt einen Code ab, den schon ein anderes Produkt hat – mit der Meldung GTIN, UPC, EAN oder ISBN ungültig oder dupliziert. Beim Import scheitert dann die ganze Zeile, und das Feld des Produkts bleibt leer. Haben zwei Produkte denselben Code, ist er meist bei einem der beiden falsch.
WooCommerce nimmt eine falsche Prüfziffer an. Es rechnet sie nicht nach, ein vertippter Code geht also ohne Warnung durch. Beanstandet wird er erst später im Google Merchant Center.

Beim Speichern behält WooCommerce vom Code nur Ziffern, Bindestriche und ein X am Ende. An Google gehen nur Codes mit 8, 12, 13 oder 14 Ziffern (welche Codes bei Google ankommen). Prüfen Sie die Codes deshalb vor dem Übertragen, nicht danach.

Codes übertragen: Export, Prüfung, Import

Dafür reichen Export und Import von WooCommerce, installieren müssen Sie nichts.

Export. Öffnen Sie Produkte und klicken Sie oben auf Exportieren. Setzen Sie in der Zeile Benutzerdefinierte Metadaten exportieren? das Häkchen bei Ja, exportiere alle benutzerdefinierten Metadaten und klicken Sie auf CSV generieren. Die alten Codes stehen dann in den Spalten Meta: hwp_product_gtin und Meta: hwp_var_gtin (WooCommerce UPC, EAN, and ISBN) oder Meta: _wpm_gtin_code (Product GTIN for WooCommerce). Das alte Plugin muss dafür nicht aktiv sein.
Datei so öffnen, dass die Codes als Text erhalten bleiben. Wenn Sie die Datei per Doppelklick öffnen, zeigt Excel einen 13-stelligen Code als 5,90123E+12 an und entfernt bei einem UPC die führende Null. Nach dem nächsten Speichern sind diese Ziffern verloren. Wählen Sie in Excel Daten → Aus Text/CSV und schalten Sie im Vorschaufenster die Erkennung der Datentypen aus. In Google Tabellen wählen Sie Datei → Importieren und entfernen das Häkchen bei der Option, die Text in Zahlen, Datumsangaben und Formeln umwandelt.
Importdatei erstellen: zwei Spalten, nur Zeilen mit Code. Die erste Spalte heißt ID, die zweite heißt GTIN, UPC, EAN oder ISBN und enthält den alten Code. Bei Product GTIN for WooCommerce ist das einfach die umbenannte Spalte Meta: _wpm_gtin_code. Bei WooCommerce UPC, EAN, and ISBN stehen die Codes der Produkte in der einen Meta-Spalte und die der Varianten in der anderen: Übertragen Sie die Codes aus beiden Spalten in dieselbe Spalte, jeden Code in die Zeile mit seiner ID. Löschen Sie jede Zeile ohne Code: Bei einem Import, der bestehende Produkte aktualisiert, löscht eine leere Zelle den Code, der schon im Feld von WooCommerce steht – das ist uns im Test passiert. Lassen Sie außerdem Produkte weg, die im Export in der Spalte GTIN, UPC, EAN oder ISBN schon einen Code haben, es sei denn, der alte Code soll ihn ersetzen.
Datei prüfen. Speichern Sie sie als CSV-Datei und öffnen Sie sie im Werkzeug EAN prüfen. Es erkennt die Spalte an ihrem Namen und listet falsche Prüfziffern, falsche Längen und doppelte Codes mit der Zeilennummer auf. Lesen Sie einen falschen Code noch einmal von der Verpackung ab. Haben zwei Produkte denselben Code, prüfen Sie beide – meist ist er bei einem davon falsch. Die Datei verlässt Ihren Browser nicht.
Import. Öffnen Sie wieder Produkte und klicken Sie oben auf Importieren (neben Exportieren). Wählen Sie die Datei aus, setzen Sie das Häkchen bei Bestehende Produkte aktualisieren und klicken Sie auf Fortfahren. Im Schritt Spaltenzuordnung ordnen Sie die Spalte GTIN, UPC, EAN oder ISBN von Hand dem gleichnamigen Feld zu: WooCommerce 11.2 ordnet sogar die eigene Spalte nicht automatisch zu (woocommerce#68736). Die Spalte ID wird automatisch zugeordnet. Danach klicken Sie auf Starte den Importer.
Importprotokoll lesen. Die letzte Ansicht zeigt, wie viele Produkte nicht importiert werden konnten. Mit Importprotokoll anzeigen sehen Sie diese Produkte einzeln. Hat WooCommerce einen Code abgelehnt, steht in der Spalte Grund für Fehlschlag die Meldung GTIN, UPC, EAN oder ISBN ungültig oder dupliziert. Das Feld dieses Produkts bleibt dann leer. Mehr zum Protokoll: CSV-Import in WooCommerce.

Wir haben einen solchen Import mit WooCommerce 11.2.1 an einfachen Produkten und an Varianten getestet: Die Codes wurden übernommen, die Varianten blieben auch ohne die Spalte Übergeordnetes Produkt ihrem Produkt zugeordnet, und ein doppelter Code wurde wie oben beschrieben abgelehnt.

Nach dem Übertragen

Stellen Sie den Feed auf das Feld von WooCommerce um. Liest ein Feed-Plugin noch das alte Feld, schickt es weiterhin die alten Codes – auch für Produkte, deren Code Sie gerade korrigiert haben. Das Feld von WooCommerce heißt _global_unique_id.
Zum Schluss das alte Plugin deaktivieren und löschen, falls es noch aktiv ist. Solange es aktiv ist, schreibt es den Code aus seinem eigenen Feld in die strukturierten Daten der Produktseite, nicht den Code aus WooCommerce. Wir haben das mit dem Quellcode beider Plugins unter WooCommerce 11.2.1 nachgestellt: Ein in WooCommerce korrigierter Code erschien nicht auf der Seite, und als das alte Feld leer war, lieferte die Seite Google eine leere GTIN.
Die alten Felder können in der Datenbank bleiben. Ohne das Plugin liest sie nur noch ein Feed, der auf sie eingestellt ist.

Danach den ganzen Katalog prüfen

Ohne weiteren Export zeigt Merchlint, welche Produkte und Varianten keine GTIN im Feld von WooCommerce haben – auch die vom Import abgelehnten – und welche Produkte denselben Code haben. Beide Prüfungen sind in der kostenlosen Version von Merchlint für WooCommerce enthalten. Sind Codes in den alten Feldern zurückgeblieben, weist die Prüfung „Ohne GTIN“ in einem Hinweis darauf hin: wie viele Produkte ihren Code nur in hwp_product_gtin, hwp_var_gtin oder _wpm_gtin_code haben und in welchem Feld (die beiden hwp_-Felder seit Version 0.3.9).

Diese Seite wurde noch nicht von Muttersprachlern geprüft. Klingt etwas falsch oder stimmt etwas nicht? Schreiben Sie an contact@merchlint.com.

Diese Seite gibt es auf

Als Nächstes, in dieser Reihenfolge