Ein WordPress-Block-Theme ist ein Theme, das vollständig auf Blöcken aufgebaut ist. Jedes Template (Header, Footer, Single, Archive, 404, Suche) liegt als HTML-Datei in den Ordnern /templates und /parts im Theme. Die gesamte Seite lässt sich visuell im Site Editor unter /wp-admin/site-editor.php bearbeiten, ohne PHP zu schreiben. Block-Themes kamen mit WordPress 5.9 (Januar 2022) und benötigen eine theme.json-Datei im Theme-Root, die globale Styles (Farben, Typografie, Abstände, Layout) in JSON definiert. Das erste Standard-Block-Theme war Twenty Twenty Two (Januar 2022), gefolgt von Twenty Twenty Three, Twenty Twenty Four und Twenty Twenty Five (Januar 2025). Full Site Editing (FSE) ist der Sammelbegriff für die Bearbeitungserfahrung von Block-Themes: Site Editor, globale Styles, Template-Bearbeitung, Template Parts, Navigation Block, Query Loop Block und das Patterns-Verzeichnis unter wordpress.org/patterns. Klassische Themes (PHP-basiert mit header.php, footer.php, functions.php und Customizer) funktionieren in WordPress 6.x weiter, aber neue Theme-Entwicklung ist seit 2022 überwiegend Block-Theme.
Was hat sich mit WordPress 5.9 (Januar 2022) geändert?
WordPress 5.9 brachte Block-Themes und Full Site Editing als stabile Funktion nach zwei Jahren Vorarbeit im Gutenberg-Plugin. Wichtige Änderungen:
- Der Site Editor ersetzt den Customizer für Block-Themes. Customizer-Panels (Headerbild, Site Identity, Widgets, Menüs) fehlen in Block-Themes.
- Templates sind HTML-Dateien mit Block-Markup (HTML-Kommentare wie
<!-- wp:paragraph -->), kein PHP. - Die neue Datei
theme.jsondefiniert globale Styles. WordPress generiert daraus zur Laufzeit CSS-Variablen. - Widget-Bereiche werden durch Template Parts und den Navigation Block ersetzt.
- Der Query Loop Block ersetzt eigene WP_Query-Schleifen in Templates für die meisten Anwendungsfälle.
Dateistruktur eines Block-Themes
mein-theme/
style.css (Theme-Metadaten-Header, kann fast leer sein)
theme.json (globale Styles, Settings, Palette, Typografie)
functions.php (optional, für Asset-Enqueue oder Hooks)
templates/
index.html
single.html
page.html
archive.html
404.html
search.html
parts/
header.html
footer.html
sidebar.html
patterns/
hero.php (registrierte Patterns)
assets/
fonts/, images/, css/, js/Was steuert theme.json?
theme.json ist die zentrale Konfigurationsdatei eines Block-Themes. WordPress liest sie zur Laufzeit und erzeugt CSS Custom Properties plus Block-Style-Presets. Wichtige Abschnitte:
- settings.color.palette: die Farbpalette im Editor, daraus entstehen Klassen wie
has-primary-background-color. - settings.typography.fontFamilies: Schriftfamilien mit eingebetteten font-face-Deklarationen. Seit WordPress 6.5 (April 2024) kann die Font Library Schriften aus Google Fonts lokal installieren.
- settings.spacing: Abstandsvorgaben für Padding und Margin und die Spacing Scale.
- settings.layout: contentSize und wideSize steuern die Ausrichtungsoptionen (Standardbreite, wide, full).
- styles: Standard-Styles seitenweit und je Block (z.B. styles.blocks.core/heading).
- customTemplates: zusätzliche Templates für den Seiten-Editor registrieren.
- templateParts: deklariert welche Parts (Header, Footer) verfügbar sind und welchem Bereich sie zugeordnet sind.
Block-Theme gegen klassisches Theme
| Aspekt | Klassisches Theme | Block-Theme |
|---|---|---|
| Templates | PHP-Dateien (header.php, single.php) | HTML-Dateien mit Block-Markup |
| Seitenanpassung | Customizer | Site Editor und globale Styles |
| Menüs | wp_nav_menu() | Navigation Block |
| Widgets | register_sidebar() und Widget-Bereiche | Template Parts und Blöcke |
| Globale Styles | CSS in style.css oder Customizer | theme.json |
| Bearbeitung | Code-Editor oder Customizer | Visueller Site Editor |
| Benötigte WordPress-Version | 3.x und neuer | 5.9 (Templates), 6.x empfohlen |
Hybride Themes und Block Template Parts
Zwischen klassischen und vollständigen Block-Themes gibt es hybride Themes. Ein hybrides Theme ist ein klassisches Theme, das FSE-Funktionen Schritt für Schritt aktiviert:
- Ein klassisches Theme kann
theme.jsonhinzufügen und globale Block-Styles nutzen, ohne Templates umzustellen. - Ein klassisches Theme kann Block Template Parts über einen
parts/-Ordner undblock_template_part()einbinden. - Ein klassisches Theme kann für einzelne Routen HTML-Templates in
templates/bereitstellen und für andere PHP behalten.
Patterns und das Pattern-Verzeichnis
Patterns sind wiederverwendbare Block-Layouts. Seit WordPress 6.0 (Mai 2022) können Themes Patterns als PHP-Dateien im Ordner patterns/ mit Header Block ausliefern. Das Verzeichnis wordpress.org/patterns hat über 600 Community-Patterns, die jeder Nutzer einfügen kann. Synced Patterns (früher Reusable Blocks, umbenannt in WordPress 6.3 August 2023) speichern eine zentrale Instanz, die überall mit aktualisiert wird.
Block-Themes und Performance
Block-Themes sind in der Regel schlanker als klassische Themes, weil sie weniger CSS ausliefern und WordPress die Styles aus theme.json generieren lässt:
- WordPress lädt Block-Stylesheets nur für Blöcke, die auf einer Seite tatsächlich verwendet werden (seit WordPress 5.8 August 2021, ausgebaut in 6.1).
theme.jsonerzeugt einen Inline-CSS-Block pro Seite (typischerweise 5 bis 15 KB) statt eines separaten Stylesheet-Requests.- Navigation Block und Query Loop Block laufen serverseitig, kein zusätzliches JavaScript im Frontend.
- Twenty Twenty Four erreicht ca. 99 PageSpeed Mobile mit einer Basisinstallation, Twenty Twenty One (klassisch) erreicht 90 bis 95.
Beliebte Block-Themes 2025
- Twenty Twenty Five: das Standard-Theme von WordPress 6.7 (November 2024).
- Twenty Twenty Four: Allzweck-Theme aus Januar 2024 mit großer Pattern-Bibliothek.
- Blocksy: freies Block-Theme mit vielen Patterns und Pro-Erweiterung.
- Kadence: hybrides Theme mit starker Block-Theme-Variante und globalen Styles.
- Ollie: Marketing-fokussiertes Block-Theme von Mike McAlister.
- Frost: minimalistisches Block-Theme von Brian Gardner.
- Spectra One, Inspiro: Block-Themes mit Patterns für Agenturen.
Migration von einem klassischen Theme zu einem Block-Theme
- Bestandsaufnahme: jede Customizer-Einstellung, jeder Widget-Bereich und jedes Custom Template auflisten.
- Basis-Block-Theme wählen oder mit
npx @wordpress/create-block-themeein neues anlegen (Create Block Theme Plugin, 2022). - Das Design System in
theme.jsonüberführen: Palette, Typografie, Abstände. - Templates in
templates/als HTML mit Block-Markup neu aufbauen. Im Site Editor visuell zusammenstellen und exportieren. - Header und Footer als Template Parts in
parts/neu erstellen. - PHP-basierte dynamische Inhalte (eigene Loops) auf den Query Loop Block oder dynamische Blöcke mit
register_block_type()umstellen. - In Staging testen. Viele klassische Plugins erwarten Customizer- oder Sidebar-APIs und brauchen Anpassungen.
Was InspectWP prüft
InspectWP erkennt, welches Theme aktiv ist, einschließlich Block-Themes, das Parent- und Child-Theme und ob das Theme bekannte Sicherheitsprobleme hat. Der Report meldet veraltete Themes, fehlende Theme Supports und Signale wie fehlende theme.json auf WordPress 6.x, die auf ein klassisches Theme hindeuten.