TYPO3 Headless entkoppelt das TYPO3 Backend von jeder Präsentationsschicht und liefert Inhalte über JSON-APIs an Websites, mobile Apps, Kioske oder IoT-Geräte – eine Flexibilität, um die TYPO3 Agentur-Teams heute standardmäßig entwickeln.
Dieser Leitfaden behandelt die Architektur, die Einrichtung von EXT:headless 4.8, echte Fallstudien aus 2025–2026, Plattformvergleiche und genau, wann TYPO3 Headless die richtige Entscheidung ist und wann nicht.
Was ist TYPO3 Headless CMS?
TYPO3 Headless ist ein architektonischer Ansatz, bei dem TYPO3 als Backend-Content-Repository fungiert und das Frontend separat aufgebaut wird, wobei die Kommunikation mit TYPO3 über eine JSON-API erfolgt.
Der „Head“, die Präsentationsschicht, wird entfernt. Derselbe Inhalt kann nun aus einer Quelle an eine Website, mobile App, einen Kiosk oder ein IoT-Gerät geliefert werden.
Headless vs. traditionelles TYPO3
Traditionelles TYPO3 (serverseitig):
- TYPO3 erhält eine Anfrage, rendert HTML mithilfe von Fluid-Templates und sendet eine fertige Seite an den Browser
- Backend und Frontend leben im gleichen Stack
- Präsentationslogik ist an das CMS gebunden
Headless TYPO3 (entkoppelt):
- TYPO3 rendert kein HTML mehr
- Inhalte werden über RESTful-API-Aufrufe angefordert und als strukturiertes JSON zurückgegeben
- Keine TYPO3 Templates, kein Fluid, keine Präsentationslogik auf dem Server
- Das Frontend kann Nuxt, React, Next.js, eine mobile App oder jeden Kanal sein, der HTTP versteht
Was gleich bleibt: Das TYPO3 Backend verwaltet weiterhin Inhaltserstellung, Bearbeitung, Workflows, Berechtigungen und Übersetzungen. Redakteure behalten ihre vertraute Oberfläche. Nur das Ausgabeformat ändert sich.
Wo TYPO3 Headless 2026 steht
Die offizielle EXT:headless Extension ist ausgereift, aktiv gepflegt und Enterprise-ready:
- Aktuelle Version: 4.8.0, veröffentlicht am 8. Mai 2026 (Macopedia / TYPO3 Extension Repository)
- Gesamte Downloads: 264.000+
- TYPO3-Kompatibilität: v12 LTS und v13 LTS
- PHP-Anforderung: 8.2+
- Eingebaute JSON-API-Abdeckung: Seiten, Navigation, mehrsprachiger Inhalt, Formulare, Frontend-Login
- Wartung durch: TYPO3 Headless Initiative (gestartet 2019, gesponsert von Macopedia)
Das Ökosystem umfasst jetzt das offizielle nuxt-typo3 Vue/Nuxt Frontend und die TYPO3 KI Extension für ChatGPT-unterstützte Übersetzungen.
Wie die TYPO3-Headless-Architektur funktioniert
TYPO3 Headless läuft auf drei unabhängig bereitstellbaren Schichten: dem TYPO3-Backend, das Inhalte speichert und verwaltet, der EXT:headless Extension, die diese als JSON bereitstellt, sowie jedem Frontend, das dieses JSON über HTTP konsumiert.
Der entkoppelte Stack – TYPO3 + JSON API + beliebiges Frontend
Inhalte fließen in eine Richtung:
- Das TYPO3 Backend speichert Seiten, Inhaltselemente, Medien und Übersetzungen genauso wie auf einer traditionellen Website
- EXT:headless fängt die Anfrage ab und liefert strukturiertes JSON statt HTML
- Das Frontend (Nuxt, React, mobil, IoT) ruft dieses JSON über HTTP ab und rendert es beliebig
Der Browser kommuniziert niemals direkt mit TYPO3. Es gibt kein Fluid-Rendering, kein PHP-generiertes Markup, keine Plugin-Ausgabe in der Antwort.
Reines Headless vs. Mixed Mode
EXT:headless unterstützt drei Modi über ein einziges Site-Config-Flag, ein Detail, das oft darüber entscheidet, ob eine Migration machbar ist:
headless = 0– Traditionelles TYPO3. Fluid rendert HTML. JSON API ist deaktiviert.headless = 1– Reines Headless. Jede Anfrage liefert JSON. Fluid wird vollständig umgangen.headless = 2– Mixed Mode. Dieselbe TYPO3-Instanz bedient beides. Anfragen mitAccept: application/jsonerhalten JSON; alle anderen erhalten die normale HTML-Seite.
Mixed Mode ist der Migrationspfad für bestehende TYPO3-Websites. Teams können ein neues Nuxt- oder React-Frontend für einen Abschnitt bereitstellen, während der Rest der Seite weiterhin über Fluid rendert – kein Big-Bang-Rebuild nötig.
JSON API vs. GraphQL auf TYPO3
EXT:headless ist JSON-first und direkt einsatzbereit. GraphQL wird über Community-Extensions unterstützt, wenn Teams typisierte Schemas, Single-Request-Feldauswahl oder strikte Client/Server-Verträge benötigen.
Für die meisten TYPO3-Projekte deckt die eingebaute JSON API den Anwendungsfall ab; GraphQL ist die richtige Wahl, wenn Frontend-Teams Schema-Introspektion verlangen oder bereits standardisiert auf Apollo / Relay arbeiten.
Vorteile von TYPO3 Headless (und ehrliche Einschränkungen)
TYPO3 Headless ist die richtige Wahl, wenn Inhalte an mehreren Orten benötigt werden. Es ist die falsche Wahl, wenn eine einzelne Website das gesamte Produkt ist und das Team keine tiefen JavaScript-Kenntnisse hat. Beide Seiten sind wichtig – Käufer, die nach diesem Keyword suchen, brauchen beide Perspektiven.
Wo TYPO3 Headless gewinnt
Alle 11 häufig genannten Vorteile lassen sich auf fünf konkrete Punkte verdichten:
- Omnichannel-Inhaltsbereitstellung – Ein TYPO3-Backend versorgt Websites, mobile Apps, Kioske, Smart Signage, Wearables und IoT-Geräte über dieselbe JSON-API. Redakteure schreiben einmal; jeder Kanal holt die aktuelle Version. Abgedeckt: Omnichannel-Publishing, bessere Medienbereitstellung, Live-Blogging, Write-once-publish-anywhere.
- Multi-Brand- und Microsite-Management – Ein Content-Engine für verschiedene Marken-Websites, Länder-Varianten, Kampagnen-Microsites und Event-Seiten. Keine doppelten CMS-Installationen notwendig. Abgedeckt: Microsite-Manager-Anwendungsfall.
- Frontend-Framework-Freiheit – Die PHP-basierte Fluid-Schicht von TYPO3 wird ersetzt durch Nuxt, React, Next.js, Angular oder Vue. Frontend-Teams liefern schneller, Interaktionen wirken modern, und das CMS ist nicht länger der Engpass. Abgedeckt: elegantes UI, Anpassungsfähigkeit, Skalierung ohne Redesign.
- Performance und Core-Web-Vitals-Gewinne – Statische und serverseitig gerenderte JS-Frontends können Core Web Vitals verbessern, wenn Caching, Bildauslieferung, Routing und Hydration korrekt gehandhabt werden. Edge-Caching von JSON-Antworten ist einfach. Abgedeckt: Geschwindigkeit, Live-Vorschau, schnell & einfach.
- Enterprise-Mehrsprachigkeit, vollständig frei und Open-Source – TYPO3 unterstützt 50+ Sprachen mit nativen Fallback-Regeln, Workspaces und granularen Berechtigungen. GPL-v2-Lizenz, keine Seat-Gebühren. Abgedeckt: 51+ Sprachunterstützung, benutzerfreundliches Interface, frei & Open-Source.
KI und LLM-Bereitschaft – Der Differenzierer 2026
Strukturiertes Headless-Content ist ein Grund, warum Unternehmen 2026 von monolithischen CMS weggehen, nicht nur wegen Multi-Channel-Auslieferung.
KI-Übersichten, ChatGPT-Suche und Perplexity zitieren Inhalte, die sie sauber parsen können. TYPO3 Headless liefert semantisches JSON mit klarer Feldstruktur: Titel, Inhalt, Metadaten, Beziehungen – genau das, was LLMs brauchen, um Inhalte zu extrahieren, zusammenzufassen und zu zitieren.
HTML, das in Fluid-Templates gerendert wird, ist für KI-Crawler schwerer interpretierbar. Dieselbe Struktur unterstützt KI-gestütztes Tagging, Auto-Übersetzung (via TYPO3-AI Extension) und Personalisierungspipelines ohne Neumodellierung der Inhalte.
Wann TYPO3 Headless die falsche Wahl ist
Vier ehrliche Hürden:
- Höhere Anfangskosten – Zwei Stacks zu bauen (TYPO3-Backend + JS-Frontend), zwei CI/CD-Pipelines, zwei Hosting-Umgebungen. Gesamtkosten im ersten Jahr höher, besonders bei Seiten unter 10.
- WYSIWYG-Live-Vorschau schwieriger – Redakteure verlieren standardmäßig die echte In-Page-Vorschau. Lösungen existieren (Preview-Deployments, Draft Mode), benötigen jedoch Engineering-Setup.
- Multi-Stack-Team erforderlich – Ein TYPO3/PHP-Entwickler allein reicht nicht mehr. Projekte benötigen Frontend-JS-Expertise (Nuxt oder React) plus DevOps für die entkoppelte Bereitstellung.
- Personalisierung und A/B-Tests komplexer – Inhalte und Auslieferung sind getrennt, daher müssen Personalisierungstools, die in die Rendering-Schicht greifen, über die API neu angebunden werden.
Wenn ein Projekt eine einsprachige, einkanalige Marketing-Website unter 20 Seiten ist und das Team keine Kapazität hat, ein JS-Frontend zu pflegen, ist traditionelles TYPO3 mit Fluid die bessere Wahl.
TYPO3 Headless vs. andere Headless-CMS-Plattformen
TYPO3 Headless ist nicht das leichtgewichtigste Headless CMS. Es ist die stärkste Wahl, wenn ein Projekt bereits Enterprise-Publishing-Regeln, mehrsprachige Governance, Berechtigungen, Workspaces und Multisite-Kontrolle benötigt.
TYPO3 CMS ist unter der GPL lizenziert, unterstützt Multisite- und Mehrsprachen-Management und bietet redaktionelle Workflow-Funktionen über Workspaces.
Strapi ist einfacher für JavaScript-Teams, die ein entwicklerorientiertes Backend bevorzugen. Contentful lässt sich als Managed SaaS schneller einführen, allerdings steigen die Kosten mit zunehmender Skalierung.
Headless WordPress eignet sich, wenn das Redaktionsteam bereits mit WordPress vertraut ist. Ernsthafte Anforderungen an Mehrsprachigkeit und Workflows hängen jedoch meist von Plugins ab. Drupal ist die nächstliegende Enterprise-Open-Source-Alternative, insbesondere für komplexe Content-Modelle und API-intensive Implementierungen.
Faktor | TYPO3 Headless | Strapi | Contentful | Headless WordPress | Drupal Headless |
Lizenzierung | Open-Source, GPL v2+ | Open-Source Core, Paid Cloud/Enterprise | Proprietary SaaS | Open-Source, GPL | Open-Source, GPL v2+ |
Enterprise-Funktionen | Starke Berechtigungen, Workspaces, Multisite, Lokalisierung | Gut, Enterprise-Tiefe benötigt Paid Tier / Custom Setup | Starke SaaS Governance & Rollen | Plugin-abhängig | Starke Berechtigungen, Workflows, strukturierter Content |
Mehrsprachigkeit | Nativ, ausgereift, für komplexe Regionen | Verfügbar, weniger tief als TYPO3/Drupal | Starkes Lokalisierungsmodell | Plugin-gesteuert | Sehr starke native Mehrsprachigkeit |
Hosting-Modell | Self-hosted oder Agentur-managed | Self-hosted oder Strapi Cloud | Vollständig Managed SaaS | Self-hosted, Managed WP oder Custom | Self-hosted oder Enterprise-managed |
Lernkurve | Hoch | Moderat für JS-Teams | Niedrig für Redakteure, moderat für Entwickler | Niedrig für Redakteure, hoher Headless-Setup | Hoch |
TCO | Höhere Build-Kosten, niedriger Lizenz-Lock-in | Moderat, steigt mit Cloud/Enterprise | Niedriger Setup, höhere wiederkehrende Plattformkosten | Geringe Einstiegskosten, Plugin-Wartungsrisiko | Höhere Build- und Wartungskosten |
Ideal-Anwendungsfall | Enterprise-Multisite, Mehrsprachigkeit, regulierte Inhalte | Produktteams bauen Custom-Apps | Schnelles Omnichannel SaaS-Rollout | Content-intensive Sites mit WP-geschulten Redakteuren | Komplexe Public-Sector, Bildung, Enterprise-Plattformen |
Die praktische Entscheidung ist einfach: Entscheiden Sie sich für TYPO3 Headless, wenn Governance genauso wichtig ist wie die Freiheit beim Frontend.
Entscheiden Sie sich für Strapi, wenn es auf Entwicklungsgeschwindigkeit ankommt, für Contentful, wenn Sie den Komfort eines verwalteten SaaS-Dienstes schätzen, für WordPress, wenn Sie mit der Veröffentlichung vertraut sind, und für Drupal, wenn die Inhaltsarchitektur äußerst komplex ist.
Was EXT:headless liefert: JSON API, Navigation, Formulare, Login
EXT:headless ist die Kern-TYPO3-Extension, die normalen TYPO3-Content in strukturiertes JSON umwandelt. Redakteure arbeiten weiterhin innerhalb von TYPO3, Entwickler erhalten sauberen API-Output für Websites, Apps, Portale, Kioske oder jedes Frontend-Framework.
Wesentliche Funktionen:
- TYPO3-Seiten und Inhaltselemente als JSON bereitstellen
- Seitenbaum und Navigationsstruktur ausgeben
- Sprach-, Übersetzungs- und Fallback-Einstellungen respektieren
- Unterstützt benutzerdefinierte Felder und Inhaltselemente
- Entwicklern erlauben, JSON-Felder mit TypoScript umzubenennen, zu verschachteln oder umzustrukturieren
- Funktioniert mit EXT:form für TYPO3-Formulare
- Unterstützt Frontend-Login-Flows über EXT:felogin
- Bewahrt TYPO3-Backend-Stärken: Berechtigungen, Workspaces, Medienverwaltung, Multisite-Management
Wichtig: EXT:headless ersetzt TYPO3 nicht. Es entfernt TYPO3 aus der Rendering-Schicht, während es als redaktionelles und Governance-System erhalten bleibt.
Unterstützende Extensions
Die meisten echten TYPO3-Projekte benötigen mehr als Basis-Seiteninhalte. Das Headless-Ökosystem deckt gängige Enterprise-Anforderungen ab:
- EXT:headless_news – JSON-Ausgabe für EXT:news-Datensätze
- headless_solr – verbindet TYPO3 Solr-Suche mit einem Headless-Frontend
- headless_powermail – stellt Powermail-Formulare über JSON bereit
- headless_gridelements – unterstützt Projekte, die noch auf Gridelements setzen
- EXT:form Support – native TYPO3-Formulare im entkoppelten Setup
- EXT:felogin Support – ermöglicht Login-bezogene Frontend-Flows
Dies macht TYPO3 Headless für komplette Websites nutzbar, nicht nur für einfache Content-APIs.
nuxt-typo3 – Der offizielle Vue/Nuxt-Frontend-Companion
nuxt-typo3 ist der Frontend-Companion für Teams, die mit Vue und Nuxt bauen. Es konsumiert EXT:headless JSON und bietet Entwicklern eine fertige Struktur für die Darstellung von TYPO3-Inhalten in einem modernen Frontend.
Hilft bei:
- Dynamischem Seitenrouting
- Rendering von TYPO3-Inhaltselementen
- Mehrsprachigen Seiten
- SEO-Metadaten
- Layout-Handling
- Server-Side Rendering über Nuxt
Einsatz, wenn das Projekt die Backend-Power von TYPO3 benötigt, aber eine Vue/Nuxt-Frontend-Erfahrung liefern will.
TYPO3-AI Extension – ChatGPT-gestützte Übersetzung
TYPO3-AI ist nicht Teil von EXT:headless, passt aber in den modernen TYPO3-Stack. Es hilft Redakteuren, Inhalte mit ChatGPT/OpenAI innerhalb von TYPO3 zu erstellen oder zu übersetzen.
Beste Anwendung:
- Schnellere Übersetzungsentwürfe
- KI-unterstützte redaktionelle Workflows
- Vorbereitung mehrsprachiger Inhalte vor JSON-Auslieferung
Es soll menschliche Überprüfung unterstützen, nicht ersetzen.
Einrichtung von TYPO3 Headless: Schritt-für-Schritt
Starten Sie mit der Installation der TYPO3 Headless Extension in einem bestehenden TYPO3-Projekt. Die sauberste Methode ist über Composer:
composer require friendsoftypo3/headless
Sie können die Extension auch manuell über den TYPO3 Extension Manager mit dem Extension Key installieren:
headless
Nach der Installation binden Sie das EXT:headless TypoScript Template in das entsprechende Site-Package oder Template-Setup ein. Dadurch kann TYPO3 Seiteninhalte als JSON statt als Standard-HTML ausgeben.
Wichtige Regel: Verwenden Sie fluid_styled_content nicht auf demselben Seitenbaum zusammen mit EXT:headless. Die Headless-Extension soll die Inhaltserstellung für diesen Baum vollständig übernehmen.
Site-Flag & TypoScript-Template konfigurieren
EXT:headless nutzt ein Site-Config-Flag, um zu entscheiden, wie TYPO3 auf Anfragen reagieren soll.
Verwenden Sie das headless-Flag so:
headless = 0– traditioneller TYPO3-Modus; Fluid rendert normales HTMLheadless = 1– reiner Headless-Modus; TYPO3 liefert JSON für jede Anfrageheadless = 2– Mixed Mode; TYPO3 liefert JSON nur, wenn die Anfrage danach fragt
Für neue Headless-Builds empfehlen wir headless = 1. Bei Migrationen ist headless = 2 meist sicherer, da dieselbe TYPO3-Instanz sowohl das alte Fluid-Frontend als auch das neue Headless-Frontend während des Rollouts bedienen kann.
JSON-Ausgabe mit TypoScript anpassen
EXT:headless fügt ein JSON Content Object hinzu. Damit können Entwickler steuern, welche Felder zurückgegeben werden und wie die JSON-Struktur aussieht.
Ein einfaches Beispiel für das Header-Feld:
lib.page = JSON
lib.page {
fields {
header = TEXT
header {
field = header
}
}
}
Ausgabe:
{
"header" : "headerFieldValue"
}
Sie können Felder auch innerhalb von JSON-Strukturen verschachteln.
lib.page = JSON
lib.page {
fields {
data {
fields {
foo = TEXT
foo {
field = bar
}
foo1 = TEXT
foo1 {
field = bar1
}
}
}
}
}
Ausgabe:
{
"data": [
{
"foo": "bar",
"foo1": "bar1"
}
]
}
An dieser Stelle wird TYPO3 Headless besonders flexibel. Teams können die Backend-Struktur von TYPO3 beibehalten und gleichzeitig die API-Ausgabe für Nuxt, React, mobile Apps oder andere Frontend-Konsumenten anpassen.
JSON-Endpunkt testen
Sobald die Extension, das TypoScript-Template und das Site-Flag konfiguriert sind, öffnen Sie die URL einer TYPO3-Seite und prüfen Sie die Antwort.
Im reinen Headless-Modus sollte die Seite JSON direkt zurückgeben. Im Mixed Mode rufen Sie die Seite mit folgendem Header auf:
Accept: application/jsonDann bestätigen Sie, dass die Antwort Seiteninformationen, Inhaltselemente, Navigation, Sprachinformationen und alle benutzerdefinierten Felder, die über TypoScript hinzugefügt wurden, enthält.
Praxisbeispiele für TYPO3 Headless: 2025–2026
EKHN – Headless Church Portal
- Entwickelt für 1,3 Millionen Mitglieder in über 1.075 Pfarreien
- Quelle beschreibt explizit einen Headless-CMS-Relaunch mit TYPO3
- Verbesserte UX, mobile Erfahrung, Barrierefreiheit und Kontrastmodus hinzugefügt
- Bestes Beispiel: Großes Public-Service TYPO3 Headless-Portal mit Fokus auf Barrierefreiheit
Quelle: TYPO3 Fallstudie
Robomow / MTD Products – Multi-Country Brand Management
- Quelle beschreibt explizit TYPO3 Headless & PWA-Implementierung
- Verstreute lokale Websites durch ein zentrales TYPO3-System ersetzt
- Unterstützt mehrsprachige Inhalte, gemeinsame Layouts und Multi-Country-Brand-Kontrolle
- Bestes Beispiel: Headless TYPO3 für internationale Content-Governance genutzt
Quelle: Macopedia Fallstudie
Raben Group – Corporate PWA in großem Maßstab
- Quelle beschreibt explizit TYPO3 Headless & PWA-Lösung
- TYPO3 als Enterprise-CMS genutzt und gleichzeitig mobile-first Frontend-Auslieferung verbessert
- Unterstützt mehrsprachige Inhalte, Integrationen, Offline-Zugriff und Unternehmens-UX
- Bestes Beispiel: Headless-Architektur hielt TYPO3 stabil und modernisierte gleichzeitig die Frontend-Auslieferung
Quelle: Macopedia Fallstudie
Arvato – Kundenportal mit Headless TYPO3
- Quelle beschreibt explizit, dass Arvato ein Headless-Setup mit TYPO3 nutzt
- Bestehendes TYPO3-Backend dient als zentrale Content-Plattform
- Inhalte werden Headless an das my arvato Kundenportal ausgeliefert
- Bestes Beispiel: TYPO3 als gemeinsames Backend für Corporate-Website-Content und Portal-Auslieferung
Quelle: TYPO3 Fallstudie
Bereit zur Auswahl TYPO3 Headless?
Wählen Sie TYPO3 Headless, wenn Ihre Inhalte mehrere Kanäle, Marken oder Märkte bedienen müssen und nicht nur eine einzelne Website. Wenn Sie Enterprise-Governance bei gleichzeitiger Frontend-Freiheit benötigen, lohnt sich die Investition. Sind Sie unsicher, stellen Sie vor der Festlegung auf die Architektur eine Anfrage.
Die Wahl des richtigen CMS ist eine strategische Entscheidung
Ein klarer Vergleich, der Ihnen hilft, basierend auf Komplexität, Sicherheit, Skalierbarkeit und langfristigen Anforderungen zu entscheiden.
FAQs
Ja. TYPO3 CMS und EXT:headless sind Open-Source, ohne Lizenzgebühr pro Nutzer. Kosten entstehen durch Implementierung, Frontend-Entwicklung, Hosting, Integrationen und Wartung.
Ja, wenn das Frontend korrekt aufgebaut ist. Nutzen Sie serverseitiges Rendering, saubere Metadaten, crawlbare URLs, strukturierte Inhalte und schnelle Seitenauslieferung.
Ja. Nutzen Sie den Mixed Mode mit headless = 2, um während der Migration normales Fluid-HTML und JSON-Antworten aus derselben TYPO3-Instanz bereitzustellen.
Nicht standardmäßig. EXT:headless ist JSON-first, aber GraphQL kann über separate TYPO3 Community-Extensions hinzugefügt werden, wenn ein Projekt typisierte Schemas benötigt.
EXT:headless 4.8 unterstützt TYPO3 v12 und v13. Der angegebene Kompatibilitätsbereich liegt bei TYPO3 v12.4.21 bis v13.4.99.
TYPO3 Headless ist die JSON-API-Schicht. TYPO3 PWA ist der Frontend-Ansatz, der diese API konsumiert, meist mit Vue/Nuxt.
Es kostet in der Regel im Voraus mehr als traditionelles TYPO3. Planen Sie Budget für TYPO3-Einrichtung, JavaScript-Frontend-Entwicklung, API-Mapping, Preview-Workflows, Hosting und Wartung ein.
Ansprechpartner für Internetagentur und TYPO3 Projekte
Sven Thelemann
Servicepartner - Deutschland

: