Zum Inhalt springen

Glossar Headless CMS

Was ist ein Headless CMS?

  • Technisches SEO
Definition

Ein Headless CMS ist ein Content-Management-System, das Inhalte speichert und ordnet und sie als Daten über eine API ausliefert, ohne eigene Darstellungsschicht. Die Website, die App oder der Bildschirm, auf dem die Inhalte erscheinen, wird getrennt gebaut. Contentful definiert es als CMS, das die Darstellungsschicht vom Backend trennt, in dem die Inhalte verwaltet werden. Manchmal wird es mit „Decoupled CMS“ gleichgesetzt, obwohl decoupled genau genommen eine andere Bauart ist.

Links ein Formular mit Feldern, Titel und Bild orange; von einem orangen Knoten tragen gepunktete Wege denselben Titel und dasselbe Bild zu einem Browserfenster und einem Telefon rechts, jeweils anders angeordnet, auf dunkelblauem Grund.
Auf dieser Seite 13
  1. Herkunft des Begriffs
  2. Geschichte und Entwicklung
  3. Wie es funktioniert
  4. Arten und Varianten
  5. Beispiele
  6. Vor- und Nachteile
  7. Abgrenzung zu verwandten Begriffen
  8. Werkzeuge
  9. Kritik und Grenzen
  10. So gehst du Schritt für Schritt vor
  11. Best Practices
  12. Häufige Fehler
  13. Wie dieser Eintrag entstanden ist
Kurz gefasst

Ein Headless CMS verwaltet Inhalte und liefert sie per API aus, ohne eigene Darstellung. Wie es funktioniert und was es von decoupled trennt.

Links ein Formular mit Feldern, Titel und Bild orange; von einem orangen Knoten tragen gepunktete Wege denselben Titel und dasselbe Bild zu einem Browserfenster und einem Telefon rechts, jeweils anders angeordnet, auf dunkelblauem Grund.

Herkunft des Begriffs

„Headless“ heißt auf Englisch „kopflos“. Merriam-Webster belegt das Adjektiv seit der Zeit vor dem 12. Jahrhundert, mit den Bedeutungen „ohne Kopf“ und „ohne Oberhaupt“. Bei einem CMS ist der Kopf die Darstellungsschicht. Sanity erklärt das mit dem Bild von Körper und Kopf: Im Körper werden die Inhalte gespeichert, im Kopf werden sie dargestellt. Ein Headless CMS behält den Körper und überlässt den Kopf anderen Systemen, die die Inhalte per API abfragen.

Geschichte und Entwicklung

Diese Daten markieren den Weg der Architektur, nicht die Entstehung des Worts:

  • 2013: Laut Contentful gründen Sascha Konietzke und Paolo Negri das Unternehmen.
  • 30. September 2015: Auf GitHub entsteht das Repository von Strapi, das das Projekt als quelloffenes Headless CMS beschreibt.
  • 6. Dezember 2016: WordPress 4.7 bringt REST-API-Endpunkte für Beiträge, Kommentare, Begriffe, Nutzer, Metadaten und Einstellungen in den Kern.
  • 24. Januar 2019: Dries Buytaert, Gründer von Drupal, unterscheidet in seinem Blog drei Architekturen: traditionell (gekoppelt), progressiv entkoppelt und vollständig entkoppelt.
  • 1. Mai 2019: Drupal 8.7 enthält das JSON:API-Modul als stabile Kernfunktion, laut Ankündigung für den Bau entkoppelter Anwendungen.

Wie es funktioniert

Am Anfang steht das Content-Modell. Laut Contentful legt das Team zuerst die Inhaltstypen und die Felder jedes Typs fest, zum Beispiel einen Typ „Artikel“ mit Titel, Haupttext, Veröffentlichungsdatum und Autor, und legt danach die Einträge an. Contentful erlaubt außerdem Verweise zwischen Einträgen, so dass der Autor ein eigener Eintrag sein kann, den mehrere Artikel nutzen.

Die Inhalte verlassen das CMS über eine API, meist als JSON. Contentful trennt zwei Haupt-APIs. Die Content Delivery API ist nur lesend, liefert veröffentlichte Inhalte und Mediendateien (Bilder, Videos) aus und läuft über ein CDN. Die Content Management API liest und schreibt: Mit ihr legst du Inhalte an und änderst sie, und sie gibt auch Unveröffentlichtes und alle Sprachfassungen zurück. Contentful rät aber davon ab, mit ihr große Mengen an Inhalten auszuliefern. Strapi bietet seine Content API über REST und GraphQL an.

Ändert sich etwas, kann das CMS andere Systeme per Webhook benachrichtigen. Contentful definiert Webhooks als HTTP-Callbacks, die bei Änderungen Bescheid geben, damit externe Systeme reagieren, etwa mit einem Neuaufbau der Website. In Strapi wählst du die Ereignisse je Inhaltstyp, zum Beispiel entry.publish.

Weil das CMS kein HTML erzeugt, entscheidet das Frontend, wo und wann jede Seite gerendert wird. Astro rendert Seiten standardmäßig beim Build als statische Dateien vor; laut Astro zeigt eine auf Abruf gerenderte Seite frisch geänderte Daten, ohne dass die ganze Website neu gebaut wird. Next.js behandelt Layouts und Seiten standardmäßig als Server Components, die auf dem Server gerendert werden. Bei statischen Seiten startet der Webhook beim Veröffentlichen den neuen Build; beim serverseitigen Rendering kommt der neue Inhalt mit der nächsten Anfrage. Wird alles im Browser zusammengesetzt, ist das clientseitiges Rendering.

Für die Redaktion ändert sich vor allem die Vorschau, denn das CMS hat die fertige Seite nicht. Contentful bietet eine Preview API mit veröffentlichten und unveröffentlichten Inhalten und eigenem Token; Produktions-Tokens funktionieren dort nicht, damit keine unveröffentlichten Inhalte nach außen gelangen. In Next.js sehen Redakteure im Draft Mode, wie ein Entwurf aussehen wird, während alle anderen Besucher weiter die gecachte Fassung bekommen. Storyblok bietet einen visuellen Editor mit Vorschau im Kontext und Abläufe für Entwurf, Prüfung und Veröffentlichung.

Welcher Token steckt in deinem Frontend?

Arten und Varianten

ArtWie es läuftBeispiele
Cloud-Dienst mit APIDer Anbieter betreibt Backend und API; das Team baut nur das FrontendContentful, Storyblok
Selbst betriebenDas Team installiert und wartet das CMS auf eigener Infrastruktur; manche Anbieter haben zusätzlich eine Cloud-FassungDirectus, Payload, Strapi
Git-basiertInhalte liegen als Dateien im Repository, neben dem CodeDecap CMS
Klassisches CMS im Headless-BetriebEin CMS mit eigenen Vorlagen liefert seine Inhalte zusätzlich per API ausWordPress (REST API), Drupal (JSON:API), Ghost (Content API)

Quelle: Dokumentation und Seiten von Contentful, Storyblok, Directus, Payload, Strapi, Decap CMS, WordPress, Drupal und Ghost (abgerufen am 15.11.2026).

Die Kategorien überschneiden sich. Hygraph nennt Strapi Cloud als Beispiel für einen Cloud-Dienst, der auf Open Source aufbaut. Wie WordPress als Headless CMS läuft, erklärt sein eigener Eintrag.

Beispiele

Contentful beschreibt den Aufruf einer Produktseite so:

  • Der Browser fordert die Seite beim Frontend an.
  • Das Frontend fragt bei der API des CMS den Eintrag dieses Produkts ab.
  • Die API prüft, ob die Anfrage erlaubt ist, und gibt die veröffentlichte Fassung als JSON zurück.
  • Das Frontend übergibt die Daten an seine Vorlage und schickt die fertige Seite an den Browser.

Dieselbe API kann gleichzeitig eine Website, eine App oder einen Bildschirm versorgen, jeweils mit eigenem Design. Ein Beispiel für das Veröffentlichen auf einer statischen Website: Eine Redakteurin veröffentlicht in Strapi einen Artikel, Strapi schickt das Ereignis entry.publish, der Build-Dienst erzeugt die Seiten mit Astro neu und das CDN liefert die neue Fassung aus.

Vor- und Nachteile

Ob sich ein Headless CMS lohnt, hängt vom Fall ab:

FallWas es bringtWas es kostet
Eine Website, viel Redaktion, wenig EntwicklungHängt davon ab, was die Redaktion braucht; ein klassisches CMS bringt das meiste schon mitEigenes Frontend, eigens gebaute Vorschau und weniger Bearbeitung direkt auf der Seite
Mehrere Kanäle (Web, App, Bildschirme)Ein Inhaltsspeicher und eine API für alle FrontendsEin Frontend je Kanal, jedes mit eigener Wartung
Mehrere SprachenDas CMS verwaltet die Übersetzungen jedes EintragsURLs je Sprache und hreflang-Tags erzeugt das Frontend
OnlineshopInhalte werden getrennt von Katalog und Bestellungen gepflegtDas CMS mit dem Shopsystem verbinden

Quelle: Contentful, „Headless CMS explained in one minute“; Sanity, „Headless CMS 101“; Dries Buytaert, „How to decouple Drupal in 2019“ (abgerufen am 15.11.2026).

Dries Buytaert fasst es so zusammen: Für eine überwiegend redaktionelle Organisation kann die Entkopplung problematisch sein, weil sie der Redaktion Kontrolle über die Darstellung nimmt.

Abgrenzung zu verwandten Begriffen

BauartWer das HTML erzeugtBeispiel
Gekoppelt (traditionell)Das CMS selbst mit seinen Vorlagen oder ThemesDrupal oder WordPress mit Theme
DecoupledDas CMS bringt eine Darstellungsschicht mit, die du nutzen kannst, aber nicht musst; es liefert auch per API ausGhost mit seiner Theme-Schicht; progressiv entkoppeltes Drupal
HeadlessEin anderes System; das CMS hat keine DarstellungsschichtContentful, Strapi

Quelle: Contentful, Abschnitt „The difference between headless CMS and decoupled CMS“; Sanity, „Headless CMS 101“; Dries Buytaert, „How to decouple Drupal in 2019“; Ghost-Dokumentation (abgerufen am 15.11.2026).

Die Begriffe werden nicht einheitlich verwendet: Contentful schreibt, manche benutzten sie gleichbedeutend, obwohl sie nicht identisch seien, und Sanity, sie würden oft vermischt. Bei Drupal heißt das, was beide headless nennen, „vollständig entkoppelt“.

Den Grundvergleich zwischen traditionellem und Headless CMS findest du im Eintrag CMS. Dasselbe Prinzip im Shop heißt Headless Commerce: Das Headless CMS verwaltet Inhalte, die Commerce-Engine die Verkaufslogik.

Werkzeuge

WerkzeugLaut Anbieter
ContentfulLiefert Inhalte über eine nur lesende API unter cdn.contentful.com aus, über ein CDN; Vorschau über eine eigene API
Directus„Collaborative Backend & Headless CMS“; selbst betrieben oder in der Directus Cloud; eigene Lizenz (MSCL-1.0), jede Version steht nach vier Jahren zusätzlich unter GPL-3.0
HygraphPlattform für strukturierte Inhalte: modelliert Inhalte als Entitäten und Beziehungen und liefert sie über eine GraphQL-API aus
Payload„The Next.js Headless CMS and App Framework“; MIT-Lizenz
Sanity„The Content Operating System for the AI era“; der Editor Sanity Studio steht unter MIT-Lizenz
StoryblokVom Anbieter betriebener Cloud-Dienst mit visuellem Editor und Vorschau im Kontext
Strapi„Open-Source TypeScript Headless CMS“; MIT-Lizenz außer dem Code der Enterprise Edition; Strapi Cloud oder selbst betrieben
WordPressKlassisches CMS, das seit Version 4.7 seine Inhalte über die REST API ausliefert

Quelle: Seiten, Dokumentation und Lizenzen der Anbieter (abgerufen am 15.11.2026). Alphabetisch, ohne Wertung.

Kritik und Grenzen

Das Frontend ist nicht dabei: Laut Contentful liegt es immer in der Verantwortung des Kunden. Sanity, das selbst ein Headless CMS verkauft, räumt ein, dass das die Kosten und den Aufwand am Anfang erhöhen kann und dass die Abhängigkeit von Entwicklern Änderungen verlangsamen kann. Funktionen, die ein klassisches CMS mitbringt, etwa das Bearbeiten direkt auf der Seite oder Layouts aus Bausteinen, musst du neu bauen; Dries Buytaert warnt, dass das zeitaufwendig und teuer sein kann.

Bei Cloud-Diensten ist die API-Nutzung je nach Tarif begrenzt. Contentful legt Aufrufe pro Sekunde und Space fest: in den bezahlten Tarifen 78 für die Delivery API und 10 für die Management API. Hygraph behauptet, die Abhängigkeit vom Anbieter sei geringer, weil die Inhalte in einem per API ausgelieferten Format vorliegen; das ist eine Aussage des Anbieters.

Von allein löst ein Headless CMS kein SEO-Problem. Title, Meta-Description, Canonical, hreflang und Sitemap müssen als Felder im Modell stehen, und das Frontend muss sie ins HTML schreiben. Google empfiehlt serverseitiges Rendering oder Pre-Rendering, weil es die Website für Nutzer und Crawler schneller macht und nicht jeder Bot JavaScript ausführt. Wie wir das mit einem Headless CMS und Astro gelöst haben, steht in unserem Artikel zu Headless CMS und SEO.

So gehst du Schritt für Schritt vor

  • Zähle die Kanäle, die die Inhalte nutzen sollen, bevor du die Architektur festlegst.
  • Lege das Content-Modell vor dem Design fest: Typen, Felder und Verweise.
  • Nimm Felder für Title, Meta-Description, Canonical und Sprache ins Modell auf.
  • Entscheide für jeden Seitentyp, ob er beim Build, auf dem Server oder im Browser entsteht.
  • Richte die Vorschau früh ein, mit der Preview API oder dem Entwurfsmodus des Frontends.
  • Verbinde den Webhook beim Veröffentlichen mit dem Build oder dem Cache.
  • Prüfe vor der Wahl des Anbieters, wie sich Inhalte und Modell exportieren lassen.

Best Practices

  • Halte die Tokens getrennt: einen Delivery-Token für die Produktion und einen eigenen für die Vorschau.
  • Liefere öffentliche Inhalte über die Delivery API aus und nutze die Management API nur zum Schreiben.
  • Filtere Webhooks nach Umgebung, damit eine Änderung im Staging nicht die Produktion neu baut.

Häufige Fehler

  • Die öffentliche Website über die Management API ausliefern.
  • Den Vorschau-Token in Code packen, der im Browser landet.
  • Alles im Browser rendern und davon ausgehen, dass jeder Bot es sieht.
  • Headless für eine kleine Website mit großer Redaktion und kaum Entwicklern wählen.

Wie dieser Eintrag entstanden ist

Dieser Eintrag entstand im November 2026 mit Unterstützung von KI. Die Angaben stammen aus der Dokumentation und den Seiten der Anbieter, den Release Notes von WordPress und Drupal, dem Blog von Dries Buytaert, der Dokumentation von Astro, Next.js und Google sowie dem Wörterbuch Merriam-Webster. Er wurde vor der Veröffentlichung geprüft und enthält keine Kundendaten.

Manuel Riveiro Rodriguez CEO & Digital Strategist

Eine technische Prüfung sieht sich das und alles Weitere in einem Durchgang an.

Audit anfragen

Häufige Fragen

Was bedeutet headless?

„Kopflos“. Der Kopf ist die Schicht, die die Inhalte darstellt; ein Headless CMS speichert sie nur und liefert sie aus.

Welche Headless CMS gibt es?

Unter anderem Contentful, Directus, Hygraph, Payload, Sanity, Storyblok und Strapi. WordPress, Drupal und Ghost sind klassische CMS, die auch im Headless-Betrieb laufen können.

Was ist der Unterschied zwischen headless und decoupled?

Ein Decoupled CMS bringt eine optionale Darstellungsschicht mit und liefert zusätzlich per API aus; ein Headless CMS hat keine Darstellungsschicht. Contentful und Sanity weisen beide darauf hin, dass die Begriffe vermischt werden.

Was sind die Nachteile eines Headless CMS?

Du musst das Frontend bauen und warten, die Vorschau einrichten und Bearbeitungsfunktionen nachbauen, die ein klassisches CMS mitbringt. Bei Cloud-Diensten ist die API-Nutzung je nach Tarif begrenzt.

Kann WordPress als Headless CMS laufen?

Ja. Seit Version 4.7 vom Dezember 2016 liefert WordPress Beiträge, Seiten und weitere Daten als JSON über seine REST API aus, und ein anderes System erzeugt die öffentlichen Seiten.

Quellen

  1. Contentful, „Headless CMS explained in one minute“, aktualisiert am 7. Juli 2026 (englisch).
  2. Contentful Docs, Content Delivery API, „Introduction“ (englisch).
  3. Contentful Docs, Content Management API, „Overview“ (englisch).
  4. Contentful Docs, Content Preview API, „Overview“ (englisch).
  5. Contentful Docs, Webhooks, „Overview“ (englisch).
  6. Contentful Docs, „Technical Limits“ (englisch).
  7. Contentful, „Content models“, Help Center (englisch).
  8. Contentful, „About Contentful“ (englisch).
  9. Sanity, „Headless CMS 101: The Only Guide You'll Ever Need“, zuletzt bearbeitet am 18. August 2025 (englisch).
  10. Sanity Studio, Repository, MIT-Lizenz (englisch).
  11. Storyblok, „Headless CMS Explained“ (englisch).
  12. Hygraph, „What Is a Headless CMS? A Guide for the Agentic Era“ (englisch).
  13. Directus, „Collaborative Backend & Headless CMS“ (englisch).
  14. Directus, Monospace Sustainable Core License 1.0 (englisch).
  15. Payload, „The Next.js Headless CMS and App Framework“ (englisch).
  16. Payload, MIT-Lizenz (englisch).
  17. Strapi, „Open-Source TypeScript Headless CMS“ (englisch).
  18. Strapi, Repository (angelegt am 30. September 2015) und Lizenz (englisch).
  19. Strapi, „Content API“ (englisch).
  20. Strapi, „Webhooks“ (englisch).
  21. Decap CMS, „Decap CMS overview“ (englisch).
  22. Ghost, „Ghost On The JAMstack“ (englisch).
  23. WordPress, „WordPress 4.7 ‚Vaughan‘“, 6. Dezember 2016 (englisch).
  24. WordPress, „REST API Handbook“ (englisch).
  25. Gábor Hojtsy, „Drupal 8.7.0 is available“, Drupal.org, 1. Mai 2019 (englisch).
  26. Dries Buytaert, „How to decouple Drupal in 2019“, 24. Januar 2019 (englisch).
  27. Astro, „On-demand rendering“ (englisch).
  28. Next.js, „Server and Client Components“ (englisch).
  29. Next.js, „How to preview content with Draft Mode in Next.js“ (englisch).
  30. Google Search Central, „Understand JavaScript SEO Basics“, aktualisiert am 4. März 2026 (englisch).
  31. Merriam-Webster, „headless“ (englisch).