Headless WordPress und WooCommerce mit Next.js: Wann es sich lohnt.
- Von
- E1NSER
- Stand
- Veröffentlicht
- Lesezeit
- 8 Min.

Kurz gesagt
Headless lohnt sich bei vielen Seiten oder Produkten, hohem Anspruch an die Ladezeit und individuellem Design. Für kleine Websites mit Standardfunktionen reicht meist ein klassisches Theme: weniger Entwicklung, nur ein System im Betrieb.
Allgemeine technische Information, Stand November 2026. Die genannten Dokumentationen können sich ändern, prüft sie vor einer Entscheidung.
Was bedeutet Headless bei WordPress und WooCommerce?
Headless heißt: WordPress bleibt für Inhalte, Medien und Shop-Daten zuständig, die Website selbst wird als eigenständige Anwendung gebaut, häufig mit Next.js. Das klassische Theme entfällt, die Anzeige übernimmt ein separates Frontend.
Die Verbindung läuft über eine Schnittstelle. Die WordPress-REST-API stellt Inhalte als JSON bereit, damit separate Anwendungen sie lesen und schreiben können. Sie ist Teil von WordPress.
Alternativ gibt es WPGraphQL, ein freies Plugin, das ein GraphQL-Schema ergänzt. Es gehört nicht zum WordPress-Kern. Laut Herstellerdokumentation erzwingt die REST-API kein Schema, GraphQL ist dagegen streng typisiert und kann mehrere Ressourcen in einer Anfrage liefern (WPGraphQL vs. WP REST API). Das ist die Sicht des Plugin-Herstellers; beide Wege sind gängige Optionen.
Für Shops kommt die WooCommerce Store API dazu. Sie stellt öffentliche Endpunkte für Produkte, Warenkorb und Checkout bereit, ist unauthentifiziert und liefert nur Daten der aktuellen Kundin oder des aktuellen Kunden. Verwaltungsdaten laufen über die authentifizierte WooCommerce-REST-API.
Wann lohnt sich Headless – und wann nicht?
Headless lohnt sich, wenn viele Seiten, ein hoher Performance-Anspruch oder ein individuelles Design ein eigenes Frontend tragen; genügt ein Standard-Theme, lohnt es sich nicht.
Es lohnt sich, wenn …
- die Website viele Seiten oder Produkte umfasst und Auslieferung aus dem CDN spürbar hilft
- die Ladezeit ein klares Ziel ist und ihr den Aufwand dafür eingeplant habt
- das Design so individuell ist, dass ein Theme es nur mit Kompromissen abbilden würde
- Inhalte über mehrere Kanäle, etwa Website, App und Newsletter, aus einem Redaktionssystem ausgespielt werden sollen
- ihr WordPress als Redaktionssystem behalten, das Frontend aber unabhängig weiterentwickeln wollt
- ihr Wartung auf beiden Seiten verlässlich organisieren könnt
Es lohnt sich nicht, wenn …
- die Website klein ist und Standardfunktionen genügen
- ihr stark auf Plugins setzt, die ihre Ausgabe im Theme erzeugen
- eure Zahlungsarten im eigenen Frontend nicht belastbar nachgewiesen sind
- Redakteurinnen und Redakteure auf eine sofortige, vollständige Vorschau angewiesen sind, ihr aber nur einen statischen Host einplant
- niemand die zwei Systeme dauerhaft betreuen soll
Wie unterscheiden sich klassisches Theme und Headless im Vergleich?
Der Hauptunterschied liegt darin, wer das Frontend ausliefert und wie viel davon individuell gebaut werden muss.
Kriterium | Klassisches Theme | Headless mit Next.js |
|---|---|---|
Frontend | Theme und Plugins in WordPress | Eigene Next.js-Anwendung |
Systeme im Betrieb | Eines | Zwei (Backend und Frontend) |
Plugin-Funktionen | Laufen im Theme | Müssen im Frontend angebunden oder ersetzt werden |
Vorschau | Eingebaut | Muss über Draft Mode oder Ähnliches gebaut werden |
SEO-Ausgabe | Über Theme und SEO-Plugin | Muss das Frontend selbst liefern |
Gestaltungsfreiheit | Durch Theme-Struktur begrenzt | Sehr hoch |
Entwicklungsaufwand | In der Regel geringer | In der Regel höher |
Auslieferung | Seitencache und Server | CDN mit vorab erzeugten Seiten möglich |
Was bringt Headless für Core Web Vitals und SEO?
Headless kann zu guten Core Web Vitals beitragen, garantiert sie aber nicht. Die drei Kennzahlen und ihre „guten“ Schwellen laut web.dev sind:
Kennzahl | Misst | Guter Wert |
|---|---|---|
LCP (Largest Contentful Paint) | Ladegeschwindigkeit | bis 2,5 Sekunden |
INP (Interaction to Next Paint) | Reaktionsfähigkeit | 200 Millisekunden oder weniger |
CLS (Cumulative Layout Shift) | visuelle Stabilität | 0,1 oder weniger |
Bewertet wird das 75. Perzentil der Seitenaufrufe, getrennt nach Mobil und Desktop. INP hat am 12. März 2024 den früheren Wert FID abgelöst (web.dev). Ältere Texte nennen noch FID.
Google schreibt, dass gute Werte mit dem übereinstimmen, was die Kernranking-Systeme belohnen wollen, und empfiehlt sie (Google Search Central). Ein Versprechen für bessere Rankings ist das nicht. Ein gut eingerichtetes klassisches Theme mit Seitencache kann die Schwellen ebenfalls erreichen. Maßgeblich sind die Feld-Daten eurer eigenen Website, nicht die Technik allein.
Worauf achtet ihr beim SEO-Umbau?
Google rendert JavaScript über eine Warteschlange, was länger dauern kann. Serverseitiges Rendern oder Prerendering bleibt laut Google eine gute Idee. Außerdem rät Google zu aussagekräftigen Statuscodes wie 404 und warnt vor Soft-404-Fehlern in clientseitigen Anwendungen.
In der Praxis heißt das: Echte 404-Antworten, Weiterleitungen, Titel, Canonicals und strukturierte Daten muss das Frontend selbst liefern. Sie kommen nicht mehr automatisch aus Theme und SEO-Plugin. Bei einem statischen Export brauchen Weiterleitungen eine Lösung auf dem Host, weil Next.js sie dort nicht ausführt.
Welche Rendering-Optionen bietet Next.js?
Next.js kann Seiten vorab erzeugen, zeitgesteuert oder auf Abruf erneuern oder bei jeder Anfrage serverseitig rendern. Für ein Headless-WordPress sind meist die ersten beiden Varianten relevant, weil sie Seiten aus dem CDN ausliefern.
Die Dokumentation kennt zwei Caching-Modelle, mit und ohne Cache Components. Mit den aktuellen create-next-app-Vorgaben ist Cache Components bereits aktiviert, in bestehenden Projekten muss es über die Option cacheComponents eingeschaltet werden (Caching). Für dieses Modell gilt eine eigene Anleitung (ISR with Cache Components). Ältere Anleitungen im Netz beschreiben oft das frühere Modell.
Die folgende Beschreibung der Incremental Static Regeneration (ISR) gilt für das Modell ohne Cache Components. Eine Seite wird aus dem Cache bedient und höchstens alle N Sekunden neu erzeugt. Die erste Anfrage nach Ablauf erhält noch die veraltete Seite, während im Hintergrund eine neue entsteht. Alternativ lässt sich eine Seite gezielt per revalidatePath oder revalidateTag erneuern, etwa wenn WordPress einen Beitrag speichert; die Seite wird dann bei der nächsten Anfrage neu aufgebaut. Schlägt die Neuerzeugung fehl, bleibt die letzte erfolgreiche Seite im Umlauf.
Dabei gibt es Grenzen, die in der Dokumentation stehen:
- ISR braucht die Node.js-Laufzeit und wird beim statischen Export nicht unterstützt.
- Bei mehreren Instanzen ist der Standard-Cache pro Instanz getrennt, eine On-Demand-Erneuerung trifft dann nur die Instanz, die den Aufruf erhält. Dafür braucht es einen gemeinsamen Cache-Handler.
- Ein statischer Export erzeugt reine HTML-, CSS- und JS-Dateien für jeden statischen Host, unterstützt aber weder ISR, Draft Mode, Cookies noch Server Actions, und auch Redirects, Rewrites und Header-Konfiguration in Next.js stehen dort nicht zur Verfügung.
Wie funktioniert der Warenkorb in einem Headless-Shop?
Der Warenkorb läuft über die Store API, entweder mit cookiebasierter Sitzung oder mit einem Cart-Token. Für euch heißt das: Warenkorb und Checkout sind im eigenen Frontend zusätzlich zu bauen und zu testen, sie kommen nicht fertig aus dem Theme.
Technisch brauchen schreibende Anfragen an den Warenkorb und alle Checkout-Anfragen laut Dokumentation einen Nonce, außer es werden Cart-Tokens verwendet. Ein Cart-Token wird von erfolgreichen Warenkorb-Anfragen zurückgegeben und kann Cookie-Sitzungen für Headless-Szenarien ersetzen (Cart Tokens). Das Frontend muss diese Sitzungslogik selbst sauber abbilden.
Was ist mit Zahlungsarten?
Bei Zahlungsarten lohnt sich die genaueste Prüfung vor der Planung. Für den Block-Checkout von WooCommerce müssen Zahlungsarten ausdrücklich eingebunden werden: mit einer Registrierung per JavaScript und einer serverseitigen PHP-Klasse. Die Abwicklung der Zahlung läuft weiter über die Payment Gateway API (Payment method integration).
Diese Anleitung bezieht sich auf den Block-Checkout von WooCommerce. Ob und wie eine Zahlungsart in einem eigenen Next.js-Frontend funktioniert, etwa bei Kartenfeldern oder einer zusätzlichen Bestätigung der Zahlung, klärt ihr deshalb pro Zahlungsart mit dem jeweiligen Anbieter, bevor das Frontend geplant wird.
Was ändert sich für Redaktion und Plugins?
Das Redaktionssystem bleibt WordPress, aber Vorschau und viele Plugin-Funktionen müssen im Frontend eigens gebaut werden.
Wie funktioniert die Vorschau?
Mit dem Draft Mode von Next.js sehen Redakteurinnen und Redakteure unveröffentlichte Inhalte, ohne auf die Erneuerung zu warten. Das CMS öffnet eine Vorschau-Adresse, die Route prüft ein geheimes Token und setzt ein Cookie. Andere Besucherinnen und Besucher sehen weiter die zwischengespeicherte Seite. Draft Mode steht in einem statischen Export nicht zur Verfügung. Wer Vorschau und schnelle Aktualisierung braucht, plant deshalb ein Hosting mit Node.js-Laufzeit.
Welche WordPress-Plugins brauchen bei Headless Mehraufwand?
Plugins, die Inhalte serverseitig im Theme ausgeben, brauchen im Frontend eine eigene Entsprechung. Ein Beispiel sind dynamische Blöcke: Sie erzeugen ihr HTML auf dem Server. Ihre Datei render.php wird laut WordPress-Dokumentation ausgeführt, um die Darstellung im Frontend zu erzeugen. Ein Next.js-Frontend führt diesen PHP-Code nicht selbst aus; es muss die Darstellung nachbauen oder die Ausgabe über eine Schnittstelle beziehen.
Prüft deshalb vor der Planung für jedes Plugin, ob es seine Daten über REST-API oder GraphQL bereitstellt und was im Frontend neu entstehen muss. Typische Kandidaten für diese Prüfung sind:
- Page Builder
- Shortcodes
- Formular-Plugins
- Cookie- und Consent-Lösungen
- Mehrsprachigkeits-Plugins
Wie sieht es mit der Sicherheit aus?
Headless verschiebt die Angriffsfläche, ohne sie automatisch zu verkleinern. Das WordPress-Backend und seine API-Endpunkte bleiben erreichbar, sofern sie nicht eingeschränkt werden. Öffentliche Inhalte sind laut REST-API-Handbuch generell auch über die API öffentlich lesbar. Für externe Anwendungen bietet WordPress Application Passwords, die laut Handbuch seit Version 5.6 enthalten sind und über HTTPS genutzt werden.
WPGraphQL deaktiviert die öffentliche Schema-Introspektion standardmäßig. Neue Installationen begrenzen zudem die Abfragetiefe, ältere behalten ihre frühere Einstellung (WPGraphQL Security).
Ein möglicher Vorteil: In Next.js sind Layouts und Seiten standardmäßig Server Components, sodass Zugangsdaten serverseitig bleiben. Nur Variablen mit dem Präfix NEXT_PUBLIC_ gelangen in den Browser (Next.js). Ob das Risiko insgesamt sinkt, hängt davon ab, wie Backend und Schnittstellen abgesichert sind.
Welchen Mehraufwand bedeutet Headless im Betrieb?
Headless bedeutet zwei Systeme, die gehostet, aktualisiert und überwacht werden müssen; der größte Posten ist meist die einmalige Entwicklung des Frontends, danach folgt die laufende Wartung beider Seiten. Die wichtigsten Faktoren:
- Entwicklung eines eigenen Frontends statt eines Themes
- Aufbau von Schnittstelle, Vorschau und Erneuerung bei Änderungen
- Ersatz oder Anbindung von Plugin-Funktionen
- Hosting für Backend und Frontend, bei mehreren Instanzen mit gemeinsamem Cache
- Monitoring, Backups und Updates auf beiden Seiten
- Pflege der Verbindung, wenn sich WordPress, WooCommerce oder Next.js ändern
Ein klassisches Theme bedeutet in der Regel weniger Entwicklungsaufwand als ein individuelles Next.js-Frontend mit API-Anbindung. Was Websites grundsätzlich kosten, erklärt der Ratgeber Was kostet eine Website in Wien?. Ob WooCommerce überhaupt die richtige Plattform ist, behandelt Shopify oder WooCommerce?.
Wie unterstützt E1NSER bei Headless-Projekten?
Wir setzen Headless-Projekte mit WordPress oder WooCommerce als Backend und Next.js als Frontend um, mehr dazu unter WooCommerce, Webdesign und Programmierung. Bei Swiss Aquatics ersetzt ein Next.js-Frontend das WordPress-Theme für mehr als 4.000 Seiten in Deutsch und Französisch, WordPress und WooCommerce bleiben im Backend. Für Everest Basmatireis haben wir ein Headless-System mit WordPress im Hintergrund und Next.js mit ISR im Frontend in Wien entwickelt. Ob Headless oder ein klassisches Theme zu eurem Vorhaben passt, besprechen wir über die Kontaktseite.
Quellen
- 01REST API Handbook – WordPress Developer Resources (wordpress.org), Stand 2026-10-14
- 02Authentication – REST API Handbook – WordPress Developer Resources (wordpress.org), Stand 2026-10-14
- 03Introduction – WPGraphQL Docs – WPGraphQL
- 04WPGraphQL vs. WP REST API – WPGraphQL (Herstellerdokumentation)
- 05Security – WPGraphQL Docs – WPGraphQL
- 06WooCommerce Store API – WooCommerce Developer Docs (Automattic)
- 07Cart Tokens (WooCommerce Store API) – WooCommerce Developer Docs (Automattic)
- 08Nonce Tokens (WooCommerce Store API) – WooCommerce Developer Docs (Automattic)
- 09Payment method integration – WooCommerce Developer Docs (Automattic)
- 10Metadata in block.json – WordPress Developer Resources (wordpress.org), Stand 2026-10-14
- 11How to implement Incremental Static Regeneration (ISR) – Next.js / Vercel docs, Stand 2026-10-15
- 12ISR with Cache Components – Next.js / Vercel docs, Stand 2026-10-15
- 13How to create a static export of your Next.js application – Next.js / Vercel docs, Stand 2026-08-09
- 14How to preview content with Draft Mode in Next.js – Next.js / Vercel docs, Stand 2026-06-02
- 15Caching (Cache Components) – Next.js / Vercel docs, Stand 2026-10-06
- 16Server and Client Components – Next.js / Vercel docs, Stand 2026-10-05
- 17Web Vitals – web.dev (Google), Stand 2024-10-31
- 18Interaction to Next Paint becomes a Core Web Vital on March 12 – web.dev (Google), Stand 2024-01-31
- 19Understanding Core Web Vitals and Google search results – Google Search Central, Stand 2025-12-10
- 20Understand the JavaScript SEO basics – Google Search Central, Stand 2026-03-04


