Shopware Content importieren: Artikel aus HTML, XML und JSON übernehmen
Vierzig Artikel liegen als HTML-Export bereit, und jetzt sollen sie in den Shop. Von Hand bedeutet das vierzig Mal kopieren, vierzig Titel, vierzig Slugs, vierzig Meta-Beschreibungen — ein Arbeitstag, in dem garantiert drei Artikel unvollständig ankommen.
Ein Import löst das, wenn er mehr übernimmt als nur den Fließtext. Entscheidend ist, welche Felder tatsächlich mitkommen: Titel, Slug, Meta-Daten, Fokus-Keyword, Inhaltstyp und Zuordnung. Dieser Artikel geht durch, was welches Format kann und wie eine saubere Importdatei aussieht.
Der Ertragswerke Content Manager liest JSON, XML, HTML und HTM ein. Wie ein kompletter Umzug ohne Ranking-Verlust abläuft — inklusive Erhalt der alten Adressen — behandelt der Ratgeber zum Migrieren bestehender Inhalte. Hier geht es um die Formate selbst.
Welche Content-Formate lassen sich in Shopware importieren?
JSON, XML, HTML und HTM. Die vier unterscheiden sich vor allem darin, wie viele Metadaten sie mitbringen können: HTML liefert im Kern den Inhalt, XML und JSON können den vollständigen Datensatz eines Artikels transportieren.
Der Vergleich
| Format | Artikel je Datei | Metadaten | Typischer Einsatz |
|---|---|---|---|
| HTML / HTM | Einer | Begrenzt, aus dem Markup ableitbar | Einzelne Seiten, Exporte aus Editoren |
| XML | Mehrere | Vollständig, wenn strukturiert | Sammelexporte aus CMS |
| JSON | Mehrere | Vollständig inklusive JSON-LD | Strukturierte Inhaltspakete |
Welches Format wann
Für einen einzelnen Artikel aus einem Word-Export oder einer HTML-Seite reicht HTML. Für dreißig Artikel aus einem bestehenden System lohnt der Aufwand, sie in XML oder JSON zu bringen — weil dann Titel, Slug und Meta-Daten mitkommen statt nachgetragen werden zu müssen.
Die realistische Erwartung
Ein Import ist keine Ein-Klick-Migration aus jedem beliebigen CMS. Die Quelldaten müssen in einem unterstützten und sinnvoll strukturierten Format vorliegen. Der Aufwand verschiebt sich damit vom Übertragen zum Aufbereiten — was bei vierzig Artikeln immer noch die deutlich bessere Rechnung ist.
Wie wird eine HTML-Datei zu einem Artikel?
Der Inhalt wird als Artikeltext übernommen, und was an Metadaten im Markup steht, wird ausgewertet: die H1 als Titel, ein vorhandener Title-Tag, eine Meta-Beschreibung. Was fehlt, ergänzt du nach dem Import.
Was übernommen werden kann
| Aus dem HTML | Wird zu |
|---|---|
| H1 | Artikeltitel |
| Title-Tag | Meta-Titel |
| Meta-Description | Meta-Beschreibung |
| Body-Inhalt | Artikeltext |
| Überschriftenstruktur | Bleibt erhalten |
Was du vorher aufräumen solltest
HTML-Exporte enthalten oft Ballast, der im Artikel nichts verloren hat:
- Navigations- und Footer-Bereiche
- Inline-Styles aus dem alten Theme
- Klassennamen, die im neuen Theme nichts bedeuten
- Kommentare und Tracking-Snippets
- absolute Links auf die alte Domain
Der letzte Punkt ist der wichtigste: Interne Links, die noch auf die alte Domain zeigen, führen nach dem Umzug ins Leere oder über einen Umweg.
Die Bilder
Bilder in einem HTML-Export verweisen auf ihre alte Quelle. Sie müssen in die Shopware-Mediathek und die Verweise entsprechend angepasst werden — sonst hängen die Artikel an einem Server, den es irgendwann nicht mehr gibt.
Wie funktioniert ein XML-Sammelimport?
Über eine Datei, die mehrere Artikel als jeweils eigenen Knoten enthält. Jeder Knoten trägt die Felder eines Artikels, und der Import legt daraus in einem Vorgang mehrere Inhalte an. Das ist der praktikable Weg bei größeren Beständen.
Der grundsätzliche Aufbau
Eine Sammeldatei enthält ein Wurzelelement und darunter je Artikel einen Eintrag mit den gewünschten Feldern — Titel, Slug, Meta-Daten, Inhalt und optional Zuordnungen. Wie die Elemente konkret heißen müssen, gibt die jeweilige Importvorlage vor.
Warum eine Vorlage der erste Schritt ist
Ohne Musterdatei entsteht bei jedem Versuch eine andere Struktur, und jeder Import scheitert an einem anderen Feld. Eine funktionierende Beispieldatei mit zwei Artikeln spart mehr Zeit als jede Dokumentation.
Der empfohlene Ablauf
- Vorlage holen und mit zwei Artikeln befüllen
- Testimport in einen Entwurfsstatus
- Ergebnis prüfen — kommen alle Felder an?
- Vollständige Datei aufbauen
- Import und Kontrolle der Zuordnungen
Schritt zwei wird gern übersprungen und ist der wertvollste. Ein Fehler bei zwei Artikeln kostet fünf Minuten, derselbe Fehler bei vierzig kostet einen Nachmittag.
Typische Stolpersteine
| Problem | Ursache |
|---|---|
| Umlaute zerschossen | Falsche Zeichenkodierung, UTF-8 verwenden |
| Import bricht ab | Nicht wohlgeformtes XML, ein fehlendes Tag reicht |
| HTML im Inhalt zerlegt die Datei | Inhalt nicht als CDATA gekapselt |
| Felder kommen leer an | Elementnamen weichen von der Vorlage ab |
Welche Daten kann ein JSON-Inhaltspaket enthalten?
Den vollständigen Datensatz eines Artikels: Titel, H1, Meta-Beschreibung, Slug, Inhaltstyp, Fokus-Keyword, Artikelinhalt, strukturiertes JSON-LD und weitere Zuordnungen. Damit ist JSON das Format mit der höchsten Übernahmequote — nach dem Import muss am wenigsten nachgearbeitet werden.
Was ein Inhaltspaket transportieren kann
| Feld | Nutzen nach dem Import |
|---|---|
| Titel | Artikelüberschrift |
| H1 | Falls abweichend vom Titel |
| Slug | Adresse des Artikels |
| Meta-Titel | Snippet |
| Meta-Beschreibung | Snippet |
| Fokus-Keyword | Prüfung und Kannibalisierungswarnung |
| Inhaltstyp | Fachartikel, Wissen, lokal |
| Artikelinhalt | Der eigentliche Text |
| JSON-LD | Strukturierte Daten |
| Zuordnungen | Pillar, Cluster, verwandte Inhalte |
Warum das Fokus-Keyword mitkommen sollte
Ein Artikel ohne Fokus-Keyword taucht in keiner Prüfung auf, wird bei keiner Kannibalisierungswarnung berücksichtigt und erscheint im Audit als Lücke. Bei vierzig importierten Artikeln bedeutet das vierzig Nacharbeiten — oder ein Feld mehr in der Importdatei.
JSON als Übergabeformat aus einer KI-Erstellung
Wer Artikel mit einem Sprachmodell vorbereitet, kann sie direkt als JSON-Paket ausgeben lassen — mit allen Feldern, die der Import erwartet. Das ist der Weg, auf dem aus einem Schreibauftrag ein fertiger Artikel im System wird, ohne Zwischenschritt. Voraussetzung ist, dass die Ausgabe exakt der erwarteten Feldstruktur folgt — sonst kommt der Inhalt an, die Metadaten aber nicht.
Wie werden bestehende SEO-URLs übernommen?
Über das Slug-Feld der Importdatei. Trägt es die Adresse, unter der ein Artikel bisher erreichbar war, entsteht er im Shop unter derselben Adresse — vorausgesetzt, die Pfadstruktur passt zusammen.
Warum der Slug ins Importfeld gehört
Ein Import, der Slugs automatisch aus dem Titel erzeugt, ändert Adressen. Bei einem Umzug bedeutet das: Alle bisherigen Adressen sind weg, alle externen Links laufen ins Leere. Wird der Slug mitgeliefert, bleibt die Adresse.
| Vorgehen | Folge |
|---|---|
| Slug aus der Quelle übernehmen | Adresse bleibt erhalten |
| Slug aus dem Titel generieren | Neue Adresse, alte bricht |
Der Pfadunterschied
Lag ein Artikel bisher unter /blog/artikelname und liegt der neue Bereich unter /ratgeber/, ändert sich die Adresse trotz identischem Slug. In diesem Fall braucht es eine Weiterleitung von der alten auf die neue Adresse — mehr dazu bei 301-Weiterleitungen und im Ratgeber zum Migrieren bestehender Inhalte.
Wie lassen sich Inhalte einem Bereich zuordnen?
Über die Zuordnungsfelder in der Importdatei oder nachträglich im Backend. Sinnvoll ist die Zuordnung beim Import — nachträglich vierzig Artikel einzeln einem Cluster zuzuweisen ist genau die Arbeit, die ein Import sparen sollte.
Was zugeordnet werden sollte
| Zuordnung | Warum |
|---|---|
| Inhaltstyp | Bestimmt Darstellung und Erwartung an die Länge |
| Silo | Übergeordneter Themenbereich |
| Pillar | Zugehörige Übersichtsseite |
| Cluster | Themengruppe |
| Verwandte Artikel | Querverbindungen |
Der pragmatische Weg bei großen Beständen
Wenn die Quelldaten keine Zuordnung enthalten, hilft eine Gruppierung nach Herkunft: Alle Artikel aus einer Kategorie des alten Systems bekommen dieselbe Cluster-Zuordnung. Das ist selten perfekt, aber deutlich besser als gar keine Struktur — nachschärfen lässt sich später.
Was ohne Zuordnung passiert
Die Artikel landen als unzugeordnete Inhalte im System. Sie erscheinen im Audit als Befund, tauchen in keinem Verlinkungsvorschlag auf und sind praktisch verwaist. Wie Struktur aufgebaut wird, steht im Ratgeber zu Pillar-Cluster-Strukturen.
Wie verhindert der Import doppelte Artikel?
Über den Slug als Kennung. Existiert bereits ein Artikel mit derselben Adresse, wird der Eintrag als Dublette erkannt statt ein zweites Mal angelegt. Ohne diese Prüfung entstehen bei einem wiederholten Import zwei Versionen jedes Artikels.
Wann ein Import mehrfach läuft
Häufiger, als man denkt:
- der erste Versuch bricht in der Mitte ab
- eine korrigierte Datei wird nachgeschoben
- ein Teilbestand wird nachträglich ergänzt
- jemand importiert dieselbe Datei versehentlich zweimal
Warum Dubletten teuer sind
Zwei Artikel mit identischem Inhalt unter zwei Adressen sind ein Kannibalisierungsfall mit Ansage. Sie konkurrieren um dieselbe Suchanfrage, teilen die internen Links und müssen anschließend zusammengelegt und weitergeleitet werden — siehe Keyword-Kannibalisierung.
Die Kontrolle nach dem Import
Nach jedem Import lohnt ein Blick auf drei Punkte:
- Stimmt die Anzahl der angelegten Artikel mit der Datei überein?
- Sind Titel, Slug und Meta-Daten vollständig angekommen?
- Gibt es Artikel ohne Fokus-Keyword oder Zuordnung?
Der dritte Punkt taucht ohnehin im Content Audit auf — direkt nach dem Import lässt er sich aber in einem Durchgang bereinigen.
Der Entwurfsstatus als Sicherheitsnetz
Ein Import in den Entwurfsstatus zeigt das Ergebnis, bevor es öffentlich ist. Stimmt etwas nicht, lässt sich korrigieren oder löschen, ohne dass Suchmaschinen die fehlerhafte Version bereits gesehen haben.
Kompatibilität
Der Ertragswerke Content Manager ist mit Shopware 6.6 und 6.7 kompatibel. Importierte Artikel sind reguläre Inhalte mit allen Feldern für Prüfung, Struktur und Verlinkung.
Häufige Fragen
Kann ich direkt aus WordPress importieren?
Nicht per Knopfdruck. Der Export muss in eines der unterstützten Formate gebracht werden — bei WordPress führt der Weg meist über einen XML- oder JSON-Export mit anschließender Aufbereitung.
Werden Bilder mit importiert?
Bildverweise kommen mit, die Dateien selbst gehören in die Shopware-Mediathek. Rechne diesen Schritt bei größeren Beständen mit ein.
Was passiert mit Formatierungen?
HTML-Struktur bleibt erhalten. Inline-Styles aus dem alten Theme solltest du vorher entfernen, sonst kämpfen sie gegen das neue Design.
Kann ich einen Import rückgängig machen?
Sicherer ist der Testlauf mit wenigen Artikeln im Entwurfsstatus, bevor die vollständige Datei läuft.
Wie viele Artikel gehen in einem Durchgang?
Bei größeren Beständen ist eine Aufteilung in Pakete übersichtlicher — ein Fehler betrifft dann nur ein Paket, nicht den gesamten Import.
Muss ich Fokus-Keywords vorher festlegen?
Es lohnt sich. Nachträglich vierzig Artikel einzeln zu ergänzen kostet mehr Zeit als ein zusätzliches Feld in der Importdatei.
Was, wenn mein Quellsystem kein passendes Format kann?
Dann führt der Weg über einen Zwischenschritt — Datenbankexport oder Aufbereitung in eine strukturierte Datei. Der Ratgeber zum Migrieren bestehender Inhalte geht darauf ein.
Ein Import ist der Anfang, nicht das Ende. Danach brauchen die Inhalte Zuordnung, interne Links und eine Prüfung im Audit. Wie das zusammenläuft, zeigt der Shopware Content Manager.