Migration von WordPress zu einem Headless CMS: ein praktischer Leitfaden

Headless zu werden entkoppelt WordPress-Inhalte vom Rendering, sodass du ein schnelles Next.js-Frontend ausliefern kannst, während Redakteure das gewohnte Backend behalten. Richtig gemacht, behältst du Rankings und gewinnst Geschwindigkeit. Nachlässig gemacht, indexierst du eine doppelte Website und verlierst am Launch-Tag Traffic. So machst du es richtig.

5 Min. Lesezeit8 Abschnitte22. Juni 2026

Geschrieben von

Kostadin Stamboliev

Gründer und Imaginator

Gründer und Imaginator von Pineido. Arbeitet in IT-Beratung, App- und Webentwicklung, technischem SEO sowie KI und Automatisierung. Liefert Produktionscode in 30-Tage-Sprints mit festem Umfang und klarer Verantwortung.

LinkedIn

Was Headless-WordPress tatsächlich bedeutet

Klassisches WordPress koppelt Inhalt und Präsentation: PHP-Themes ziehen bei jeder Anfrage aus der Datenbank und rendern HTML. Headless trennt diese Belange. WordPress verwaltet weiterhin die Inhalte (deine Redakteure behalten dasselbe Backend), stellt sie aber statt des Renderns von Seiten über eine API bereit. Ein separates Frontend, im Jahr 2026 fast immer Next.js, holt diese Inhalte und rendert die öffentliche Website. Der Gewinn ist real: statisch oder am Edge gerenderte Seiten laden routinemäßig in unter einer Sekunde aus einem CDN, und die aggregierten Daten belegen das. Das HTTP Archive Web Almanac stellte fest, dass nur etwa 40% der mobilen WordPress-Seiten alle Core Web Vitals bestehen, der niedrigste Wert unter den führenden CMS-Plattformen, während gut gebaute Headless-Frontends häufig über 90% erreichen. Doch die Architektur ermöglicht dieses Ergebnis, sie garantiert es nicht. Eine schlecht gebaute Headless-Seite, die Komponenten überhydriert und ein React-Bundle von über 500KB ausliefert, verliert jedes Mal gegen eine gut gecachte klassische WordPress-Seite.

Zuerst entscheiden: Brauchst du das wirklich?

Der ehrlichste Rat in diesem ganzen Bereich lautet: nicht migrieren, wenn du keinen Grund hast. Wenn deine WordPress-Seite langsam ist, kannst du das oft für 50 Dollar im Monat beheben, mit besserem Hosting, WP Rocket oder Nginx-FastCGI-Caching, einem Redis-Object-Cache und Bildoptimierung. Ein Headless-Build kostet typischerweise das 2- bis 3-Fache eines vergleichbaren klassischen WordPress-Projekts, weil du nun eine separate Frontend-Anwendung, Deployment-Infrastruktur und individuelle SEO-Verkabelung wartest. Headless rechnet sich, wenn du anspruchsvolle Performance-Anforderungen mit passendem Budget hast, wenn du aus einer einzigen Content-Quelle an mehrere Frontends (Web, App, Kiosk) ausspielst oder wenn du eine moderne komponentenbasierte Entwicklererfahrung möchtest, die dein Team langfristig pflegt. Wenn deine aktuelle Seite bereits über 80 bei PageSpeed liegt, behebe zuerst, was du hast.

REST-API oder WPGraphQL

Das ist die zentrale technische Weggabelung. Die REST-API ist in WordPress enthalten (seit 4.7), braucht kein Plugin und bringt dich mit der halben Komplexität etwa 80% des Wegs. WPGraphQL ist ein kostenloses Plugin mit über 100.000 aktiven Installationen, mit dem das Frontend in einer Abfrage genau die benötigten Felder anfordern kann und so das Over-Fetching vermeidet, zu dem REST neigt. Für eine inhaltsreiche Seite mit verschachtelten Daten (Beiträge, Autoren, Begriffe, benutzerdefinierte Felder in einer Anfrage) ist WPGraphQL die zusätzliche Abhängigkeit und Lernkurve wert. Wenn dein Team kein GraphQL kennt und die Datenform einfach ist, ist REST die pragmatische Standardwahl. So oder so brauchst du zusätzliche Verkabelung, wenn du Advanced Custom Fields verwendest: ACF-Werte liegen in wp_postmeta und erscheinen ohne aktivierte REST-Ausgabe pro Feldgruppe nicht in REST, und GraphQL-Stacks benötigen sowohl WPGraphQL als auch das Plugin WPGraphQL for ACF.

Inhalte und Medien ohne Datenverlust exportieren

Hier brechen Migrationen still und leise. Der Standard-XML-Export von WordPress verstümmelt Medien, weil Bilder als Beiträge gespeichert werden, deren IDs beim Import neu generiert werden, sodass ACF-Bildfelder, die auf eine alte ID verweisen, am Ende ins Leere zeigen. Die zuverlässige Reihenfolge ist Medien zuerst: Lade die Assets vor dem Import der Inhalte in dein CDN oder deinen Cloud-Speicher hoch (S3, Cloudinary oder die Asset-Pipeline deines CMS) und schreibe dann die Medienverweise während der Transformation auf die neuen URLs um. Für Felddaten funktionieren sowohl WP All Export Pro mit dem ACF-Add-on als auch ein geskripteter Export, der acf_get_field_groups() durchläuft und nach JSON ausgibt; exportiere die ACF-Feldgruppendefinitionen separat über ACF > Tools. Plane zusätzliche Zeit für Builder-Inhalte ein: Elementor, Divi und WPBakery verweben Inhalt mit Layout-Markup in Shortcodes und serialisierten Daten, was einer sauberen automatisierten Extraktion widersteht. Behandle visuell gebaute Seiten als manuelle Migrationsarbeit.

SEO bewahren: der Teil, der über Erfolg entscheidet

Die meisten Ranking-Verluste bei Headless-Migrationen kommen von zwei Versäumnissen. Erstens: Meta-Tags und JSON-LD, die nach dem Laden per JavaScript eingefügt werden. Google sieht sie möglicherweise nicht. Die Lösung ist nicht verhandelbar: Rendere Meta-Titel, Beschreibungen, Canonicals, Open Graph und strukturierte Daten in der eigentlichen HTML-Antwort mittels SSG, SSR oder ISR, niemals nur clientseitig. Behalte Yoast oder Rank Math als einzige Quelle der Wahrheit für diese Metadaten und lies sie über die API aus. Zweitens: der weiterhin laufende WordPress-Origin, der als Duplikat indexiert wird. Riegle ihn ab: robots.txt blockiert alles außer den REST- und GraphQL-Endpunkten, sende X-Robots-Tag: noindex bei jeder HTML-Antwort vom Origin und entferne die Origin-Sitemap oder gib eine 410 zurück. Die sicherste URL-Strategie ist, die Pfade identisch zu halten (wenn /blog/my-post weiterhin /blog/my-post bleibt, bemerkt Google es kaum). Wo URLs sich ändern müssen, bilde jede vor dem Launch in einer CSV auf eine 301 ab und prüfe sie im QA; eine korrekt konfigurierte 301 gibt den vollen PageRank weiter.

QA vor dem Launch und das Umstellungsfenster

Crawle deine bestehende Seite vollständig mit Screaming Frog, Sitebulb oder Ahrefs, bevor du irgendetwas anfasst, und erfasse Archive, Tag-Seiten, paginierte Serien, Autorenseiten und benutzerdefinierte Beitragstypen, nicht nur die offensichtlichen URLs. Richte dann denselben Crawler auf das Staging und jage nach 404ern, fehlenden Canonicals, defekten internen Links und falschen Statuscodes. Ziehe eine Zufallsstichprobe von 50 alten URLs und bestätige, dass jede eine 301 zum korrekten Ziel zurückgibt. Erzeuge eine einzige kanonische Sitemap aus dem Frontend, damit die URLs exakt mit der öffentlichen Seite übereinstimmen, und leite die alte WordPress-Sitemap per 301 darauf um. Die DNS-Umstellung ist der riskanteste Moment: ziele darauf ab, von der Umschaltung bis zur vollständigen Validierung in unter vier Stunden zu kommen, und reiche die Sitemap dann sofort in der Search Console erneut ein. Bei großen Seiten phasenweise vorgehen. Migriere den Blog, validiere 1 bis 2 Wochen lang und verschiebe dann den nächsten Bereich, um den Wirkungsradius zu begrenzen.

Inhalte nach dem Launch aktuell halten

Statische Seiten sind schnell, veralten aber, also richte On-Demand-Revalidierung ein, statt auf zeitbasierte Neubauten zu warten. Das Muster: Ein WordPress-Webhook (das Plugin WP Webhooks oder ein eigener save_post-Hook) sendet ein POST an eine Next.js-Route /api/revalidate mit einem geheimen Token und dem betroffenen Pfad oder Tag, sodass nur geänderte Seiten neu generiert werden. Tag-basierte Invalidierung ist sauberer, wenn eine Bearbeitung viele Seiten betrifft. Eine Hosting-Einschränkung, die Teams beißt: On-Demand-ISR braucht einen Host, der die Revalidierungs-API von Next.js unterstützt. Vercel kann das nativ; einige Managed-WordPress-Hosts und Multi-Container-Setups mit Docker oder Kubernetes nicht, weil ein Revalidierungsaufruf immer nur einen Container erreicht. Füge auf der WordPress-Seite einen Redis-Object-Cache und einen GraphQL-Response-Cache hinzu, damit API-Antworten nicht bei jeder Neugenerierung neu berechnet werden.

Budget und wo Pineido hineinpasst

Das Hosting für das Frontend ist anfangs bescheiden, aber nutzungsabhängig abgerechnet. Vercel Pro kostet 20 Dollar pro Platz und Monat mit 20 Dollar Nutzungsguthaben, und die Kosten, die Leute überraschen, sind Bandbreite (mit 0,15 Dollar/GB jenseits des 1-TB-Pro-Kontingents abgerechnet), Edge-Anfragen sowie ISR-Lese- und -Schreibvorgänge. Setze Ausgabenwarnungen bei 75% und 100%. Der größere Posten ist die Migrations-Engineering-Arbeit selbst, und das ist genau die Art begrenzter, folgenreicher Arbeit, die zu einem Sprint mit festem Umfang passt. Pineido führt WordPress-zu-Headless-Migrationen als 30-tägigen Festpreis-Sprint zu 8.500 Dollar durch: Content- und Medienexport mit Umschreibung der Verweise, ein Next.js-Frontend auf WPGraphQL oder REST, serverseitig gerendertes SEO, eine vollständige 301-Weiterleitungskarte, Origin-Abriegelung und On-Demand-Revalidierung, mit einem Crawl-Diff vor dem Launch, damit du siehst, dass nichts zurückgefallen ist, bevor du das DNS umstellst.

Bereit zum Launch?

Sagen Sie uns, wo Sie feststecken. Wir prüfen es und senden Ihnen innerhalb eines Werktags eine konkrete Empfehlung.

Häufig gestellte Fragen

Verliere ich SEO-Rankings, wenn ich auf Headless umstelle?

Nicht, wenn die Migration korrekt durchgeführt wird. Ranking-Verluste entstehen durch zwei vermeidbare Fehler: Meta-Tags und strukturierte Daten mit clientseitigem JavaScript einzufügen, statt sie ins HTML zu rendern, und den alten WordPress-Origin crawlbar zu lassen, sodass er als Duplikat indexiert wird. Rendere alle SEO-Metadaten serverseitig, halte URLs wo möglich identisch (oder bilde jede Änderung auf eine 301 ab) und versieh den Origin mit noindex plus Robots-Sperre. Migrationen, die Canonicals, Weiterleitungen, Sitemaps und strukturierte Daten bewahren, ranken danach in der Regel gleich gut oder besser.

Sollte ich die WordPress-REST-API oder WPGraphQL verwenden?

REST ist in WordPress enthalten, braucht kein Plugin und ist die einfachere Standardwahl für Seiten mit unkomplizierten Daten. WPGraphQL (ein kostenloses Plugin mit über 100.000 Installationen) lässt das Frontend in einer Abfrage genau die benötigten Felder holen, was für inhaltsreiche Seiten mit verschachtelten Daten wie Beiträgen, Autoren, Begriffen und benutzerdefinierten Feldern besser ist. Wähle REST für Einfachheit, WPGraphQL für Abfragepräzision und Performance bei komplexen Inhaltsmodellen.

Überstehen meine Advanced Custom Fields die Migration?

Ja, aber sie brauchen zusätzliche Behandlung. ACF-Werte liegen in wp_postmeta und erscheinen nicht in der REST-API, sofern du nicht die REST-Ausgabe pro Feldgruppe aktivierst, und GraphQL-Setups benötigen sowohl WPGraphQL als auch WPGraphQL for ACF. Exportiere die Feldgruppendefinitionen separat über ACF > Tools und exportiere die eigentlichen Felddaten mit WP All Export Pro plus dem ACF-Add-on oder einem Skript. Achte besonders auf Bildfelder, da der Standard-WordPress-Export die Medien-ID-Verweise zerstört.

Kann mein Team nach der Migration weiterhin Inhalte in WordPress bearbeiten?

Ja, das ist der Hauptreiz von Headless. WordPress bleibt das Content-Backend und Redakteure behalten dieselbe Administrationsoberfläche, Beiträge, Seiten und Mediathek. Die einzige Änderung ist, dass Inhalte über die API an ein separates Next.js-Frontend veröffentlicht werden. Mit per Webhook eingerichteter On-Demand-Revalidierung erscheinen Bearbeitungen innerhalb von Sekunden nach dem Speichern auf der Live-Seite, ohne einen vollständigen Neubau oder ein Entwickler-Deployment.

Was kostet eine Headless-WordPress-Migration?

Ein Headless-Build kostet typischerweise das 2- bis 3-Fache eines vergleichbaren klassischen WordPress-Projekts, weil du eine separate Frontend-Anwendung, Deployment-Infrastruktur und individuelle SEO-Verkabelung wartest. Das Frontend-Hosting beginnt bescheiden (Vercel Pro kostet 20 Dollar pro Platz und Monat, mit nutzungsabhängig abgerechneter Bandbreite und ISR-Nutzung obendrauf). Pineido führt die Migration selbst als 30-tägigen Festpreis-Sprint zu 8.500 Dollar durch, der Export, das Next.js-Frontend, serverseitig gerendertes SEO, Weiterleitungen und Revalidierung abdeckt.

Wie lange dauert eine Headless-WordPress-Migration?

Eine typische Content-Website dauert 2 bis 4 Wochen: Content- und Medienexport mit Umschreibung der Verweise, Aufbau des Next.js-Frontends, Verkabelung von serverseitigem SEO und Revalidierung sowie ein gründlicher Crawl vor dem Launch. Große oder builder-lastige Seiten dauern länger, weil Inhalte aus Elementor, Divi und WPBakery einer sauberen automatisierten Extraktion widerstehen und oft eine manuelle Migration brauchen. Seiten mit über 5.000 Beiträgen, mehrsprachigen Inhalten oder komplexen benutzerdefinierten Feldern sind eine andere Projektklasse und profitieren von einem phasenweisen, abschnittsweisen Rollout.

Wöchentliche Impulse für den Betrieb

Schließen Sie sich Betreibern von Dienstleistungsunternehmen an, die jede Woche einen umsetzbaren Impuls zu Betrieb, Automatisierung und Wachstum erhalten.

Wir prüfen kurz, ob Sie ein Mensch sind. Gleich können Sie senden.

Kein Spam. Jederzeit abbestellbar.

Sie sind angemeldet! Die nächste Ausgabe kommt in Ihr Postfach.