Von WooCommerce migrieren

Diese Anleitung deckt den vollständigen Wechsel von WooCommerce zur neuen Plattform ab. Sie können Produkte, Kunden, Bestellhistorie, Blog-Beiträge und Seiten übertragen — entweder per direkter API-Verbindung oder über Exportdateien aus WordPress.

Was Sie migrieren können

Daten	API	Datei	Hinweis
Produkte (einfach)	Ja	Ja	Vollständig inkl. Beschreibung
Produkte (variabel)	Ja	Ja	Varianten werden korrekt erkannt
Produktbilder	Ja	Ja	Per URL-Download, HTTPS-only
Kategorien	Ja	Ja	Werden automatisch angelegt
Produktattribute	—	Ja	Spalten „Attribut N Name/Wert"
ACF-Metafelder	—	Ja	Spalten mit `meta:`-Präfix
Kunden + Adressen	Ja	Ja	Abgleich per E-Mail
Passwörter	Nein	Nein	Kunden müssen Passwort neu setzen
Blog-Beiträge	—	Ja	WordPress XML (WXR)
Seiten	—	Ja	WordPress XML (WXR)
Bestellhistorie	Ja	Ja	Nur lesend, keine Zahlungsaktionen
Gutscheine	Nein	Nein	Manuell neu anlegen
Bewertungen	Nein	Nein	Manuell übertragen

Option A: Per API verbinden

WooCommerce-API-Schlüssel erstellen

Melden Sie sich in Ihrem WordPress-Admin an.
Navigieren Sie zu WooCommerce → Einstellungen → Erweitert → REST-API.
Klicken Sie auf Schlüssel hinzufügen.
Füllen Sie das Formular aus:
- Beschreibung: z. B. „Migration zu neuer Plattform"
- Benutzer: Wählen Sie Ihren Administrator-Account
- Berechtigung: Nur lesen (Lesezugriff genügt für die Migration)
Klicken Sie auf API-Schlüssel generieren.
Kopieren Sie Consumer Key und Consumer Secret — beide Werte werden nur einmal angezeigt.

Verbindung im Migration Hub herstellen

Öffnen Sie Admin → Migration.
Wählen Sie die WooCommerce-Kachel.
Wählen Sie Per API verbinden.
Geben Sie ein:
- Shop-URL: Vollständige URL Ihres WooCommerce-Shops, z. B. https://mein-shop.de
- Consumer Key: Der generierte Schlüssel
- Consumer Secret: Das generierte Geheimnis
Klicken Sie auf Verbinden. Die Verbindung wird sofort überprüft.
Bei Erfolg erscheinen die verfügbaren Datensätze (Produkte, Kunden, Bestellungen).

Produkte per API importieren

Navigieren Sie zu Admin → Migration → Produkte.
Das Banner zeigt Ihre Verbindungsdetails und die Produktanzahl.
Klicken Sie auf Produkte importieren.
Der Import läuft in Batches von 50 Produkten. Bei großen Katalogen dauert es einige Minuten.
Die Importzusammenfassung zeigt:

Zähler	Bedeutung
Erstellt	Neue Produkte angelegt
Aktualisiert	Produkte mit vorhandener SKU überschrieben
Übersprungen	Duplikate ohne Änderung
Fehlgeschlagen	Details per Klick einsehbar
Bilder geladen	Erfolgreich heruntergeladene Bilder
Kategorien angelegt	Neue Kategorien aus WooCommerce-Kategorien

Kunden per API importieren

Navigieren Sie zu Admin → Migration → Kunden.
Klicken Sie auf Kunden importieren.
Die Zusammenfassung zeigt neue Kunden, aktualisierte Kunden und importierte Adressen.

Wichtig: Passwort-Hashes werden nie übertragen. Ihre Kunden müssen beim ersten Login die Passwort-vergessen-Funktion nutzen. Mehr dazu unter Kunden: Passwörter nach Migration.

Bestellhistorie per API importieren

Navigieren Sie zu Admin → Migration → Bestellungen.
Klicken Sie auf Bestellungen importieren.
Ein Hinweis-Banner erklärt: Importierte Bestellungen sind permanent lesend — keine E-Mails, keine Zahlungsaktionen, keine Rechnungserstellung.
Die Zusammenfassung zeigt: importierte Bestellungen, verknüpfte Kunden, per SKU zugeordnete Produkte, und nicht zuordenbare SKUs.
Notieren Sie die Batch-ID für einen möglichen Rollback.

Option B: Exportdateien hochladen

Produkte aus WooCommerce exportieren

Navigieren Sie in WordPress zu WooCommerce → Produkte.
Klicken Sie auf Exportieren.
Einstellungen:
- Welche Spalten exportieren? → Alle Spalten
- Welche Produkte exportieren? → Alle Produkte
- CSV-Trennzeichen → Komma (,)
Klicken Sie auf Export starten.

Das System erkennt folgende WooCommerce-Spalten automatisch:

WooCommerce-Spalte	Importiert als
`Name`	Produkttitel
`SKU`	Artikelnummer (Abgleichsschlüssel)
`Description`	Ausführliche Beschreibung
`Short description`	Kurzbeschreibung
`Regular price`	Verkaufspreis
`Sale price`	Aktionspreis
`Tax class`	Steuersatz
`Stock`	Lagerbestand
`Categories`	Kategorien (automatisch angelegt)
`Images`	Produktbilder (URLs)
`Tags`	Produkt-Tags
`Slug`	URL-Slug
`Attribut N Name`	Attributname
`Attribut N Wert(e)`	Attributwerte
`meta:feldname`	Produktattribut (ACF-Metafelder)

Produkte importieren:

Navigieren Sie zu Admin → Migration → Produkte.
Ziehen Sie die CSV-Datei in den Upload-Bereich (max. 10 MB).
Klicken Sie auf Importieren.

WordPress-Blog-Beiträge und Seiten exportieren

Öffnen Sie WordPress Admin → Werkzeuge → Daten exportieren.
Wählen Sie Alle Inhalte (exportiert Beiträge, Seiten und andere Inhaltstypen).
Klicken Sie auf Exportdatei herunterladen. Sie erhalten eine .xml-Datei im WXR-Format.

Inhalte importieren:

Navigieren Sie zu Admin → Migration → Inhalte.
Das Format wird automatisch erkannt, wenn Sie eine .xml-Datei ablegen (Badge: „WordPress XML erkannt").
Optional: Aktivieren Sie Eingebettete Bilder herunterladen, um Bilder aus Beitrags-Inhalten ebenfalls zu importieren (dauert länger).
Klicken Sie auf Hochladen & Importieren.
Die Zusammenfassung zeigt: erstellte Blog-Beiträge, erstellte Seiten, übersprungene Duplikate.

Was beim XML-Import passiert:

WordPress-Shortcodes wie [gallery] oder [caption] werden automatisch entfernt
Alle importierten HTML-Inhalte werden bereinigt (script-Tags werden entfernt)
Bereits vorhandene Slugs werden übersprungen — ein erneuter Import ist sicher

Kunden exportieren und importieren

Export aus WooCommerce:

Navigieren Sie zu WooCommerce → Berichte → Kunden.
Klicken Sie auf CSV herunterladen.

Alternativ über den WordPress-Benutzerexport:

Navigieren Sie zu Benutzer → Alle Benutzer → Exportieren.

Import:

Navigieren Sie zu Admin → Migration → Kunden.
Legen Sie die CSV-Datei ab. Das System erkennt das WooCommerce-Format automatisch (Badge: „WooCommerce-Format erkannt").
Prüfen Sie die vorausgefüllten Feld-Zuordnungen. Unbekannte Formate zeigen einen manuellen Zuordnungsschritt mit Dropdowns.
Klicken Sie auf Importieren.

Zeilen ohne gültige E-Mail werden übersprungen. Kunden werden per E-Mail abgeglichen.

Bestellungen exportieren und importieren

Navigieren Sie zu WooCommerce → Bestellungen → Exportieren.
Wählen Sie den gewünschten Zeitraum.
Navigieren Sie zu Admin → Migration → Bestellungen.
Legen Sie die CSV-Datei ab. Das WooCommerce-Format wird automatisch erkannt.
Klicken Sie auf Importvorschau, um eine Voransicht zu erhalten (ohne Datenbankänderungen).
Klicken Sie auf Import ausführen, um zu bestätigen.

Bilder in großer Menge importieren

Falls Produktbilder nach dem Import fehlen, importieren Sie sie nachträglich:

Navigieren Sie zu Admin → Migration → Medien.
Zip-Upload: Archiv mit Bildern hochladen (max. 500 MB gesamt, je Datei max. 10 MB, Formate: jpg, png, webp, gif, svg).
URL-Liste: URLs einfügen (eine pro Zeile, max. 500 URLs, HTTPS erforderlich).

SEO-Weiterleitungen einrichten

WooCommerce-Produkt-URLs (z. B. /produkt/massivholz-bett/) unterscheiden sich von den neuen Shop-URLs. Ohne Weiterleitungen gehen Search-Engine-Rankings verloren.

→ SEO-Weiterleitungen automatisch generieren

Häufige Probleme

Problem	Ursache	Lösung
Umlaute werden falsch dargestellt	CSV nicht als UTF-8 exportiert	In Excel: „Speichern unter → CSV UTF-8 (durch Trennzeichen getrennt)"
Varianten erscheinen als einzelne Produkte	Falscher Import-Modus	WooCommerce-CSV-Modus statt Standard-CSV verwenden
Bilder werden nicht geladen	Alte Domain nicht mehr erreichbar	Bilder manuell per ZIP unter Migration → Medien hochladen
Kategorien fehlen	Kategorie-Spalte im Export leer	In WooCommerce prüfen, ob Kategorien den Produkten zugewiesen sind
Preis-Fehler	Komma als Dezimaltrennzeichen	WooCommerce exportiert Punkte — Locale-Einstellung beim Export prüfen

Häufige Fragen

Kann ich den Import rückgängig machen? Ja. Nutzen Sie die Rollback-Funktion. Alle importierten Datensätze werden auf Entwurf gesetzt (Produkte, Inhalte) oder storniert (Bestellungen).

Was passiert mit WooCommerce-Gutscheinen? Gutscheine werden nicht migriert. Legen Sie sie manuell unter Admin → Gutscheine neu an.