Editor-Werkzeuge mit theme.json zentral festlegen
Farben, Schriften, Abstände und Layoutwerkzeuge bilden im WordPress-Editor die Gestaltung eines Themes ab. settings in der theme.json bündelt diese Auswahl zentral und stellt sie für die Bearbeitung von Inhalten bereit.
Der Bereich settings in der theme.json bestimmt, welche Gestaltungswerkzeuge und Presets im WordPress-Editor erscheinen. Dazu gehören Farbpaletten, Schriftgrössen, Inhaltsbreiten und Abstandsoptionen.
Die Konfiguration überträgt das Designsystem des Themes in die Bearbeitungsoberfläche. Redakteurinnen und Redakteure arbeiten dadurch mit benannten Werten, die zentral im Theme gepflegt werden.

Editor-Werkzeuge zentral definieren
Eine kompakte Grundstruktur zeigt die wichtigsten Einstellungsbereiche:
{
"$schema": "https://schemas.wp.org/trunk/theme.json",
"version": 3,
"settings": {
"appearanceTools": true,
"color": {},
"typography": {},
"layout": {},
"spacing": {},
"blocks": {}
}
}
appearanceTools aktiviert eine Gruppe häufig verwendeter Gestaltungswerkzeuge. Die einzelnen Bereiche erhalten anschliessend eigene Presets und blockbezogene Vorgaben.
Farbpalette im Editor bereitstellen
Eine projektspezifische Farbpalette stellt die Farben des Themes im Editor zur Auswahl. WordPress erzeugt aus den Slugs gleichzeitig CSS-Variablen wie --wp--preset--color--accent.
"color": {
"palette": [
{ "name": "Akzent", "slug": "accent", "color": "#2f6b4f" },
{ "name": "Fläche", "slug": "surface", "color": "#faf9f2" }
]
}
Die Bezeichnungen erleichtern die Auswahl im Editor, während die Slugs eine stabile technische Grundlage für Styles im Theme bilden.
Typografie als Presets organisieren
Schriftfamilien und Schriftgrössen werden ebenfalls als benannte Presets hinterlegt. Dadurch erscheinen verständliche Bezeichnungen im Editor, während das Theme mit den zugehörigen Slugs arbeitet.
"typography": {
"fontFamilies": [
{
"name": "Helvetica",
"slug": "helvetica",
"fontFamily": "Helvetica, sans-serif"
}
],
"fontSizes": [
{ "name": "Basis", "slug": "base", "size": "1rem" },
{ "name": "Gross", "slug": "large", "size": "2rem" }
]
}
Selbst gehostete Schriftdateien können bei Bedarf zusätzlich über fontFace eingebunden werden. Für die grundlegende Struktur genügt die Definition der Schriftfamilie.
Layout und Gestaltungswerkzeuge abstimmen
layout legt die reguläre und die breite Inhaltsgrösse fest. Die Bereiche spacing und border bestimmen, welche Werkzeuge für Abstände und Rahmen im Editor angeboten werden.
"layout": {
"contentSize": "730px",
"wideSize": "1220px"
},
"spacing": {
"blockGap": true,
"margin": true,
"padding": true,
"units": ["px", "rem", "%"]
},
"border": {
"color": true,
"radius": true,
"style": true,
"width": true
}
settings stellt diese Werkzeuge bereit. Konkrete Standardwerte wie ein fester Blockabstand oder eine Rahmenfarbe werden im Bereich styles definiert.
Einstellungen für einzelne Blöcke ergänzen
Globale Einstellungen lassen sich für einzelne Blöcke erweitern. Das folgende Beispiel stellt dem Button die Rahmenoptionen bereit und verwendet fest definierte Schriftgrössen aus dem Theme:
"blocks": {
"core/button": {
"border": {
"radius": true,
"width": true
},
"typography": {
"fontSize": false
}
}
}
So erhält jedes Inhaltselement die Werkzeuge, die zu seiner Gestaltung gehören. Dieselbe Struktur steht auch für weitere Core- und eigene Blöcke zur Verfügung.
Settings und Styles zusammenführen
settings definiert die Auswahlmöglichkeiten im Editor. styles verwendet diese Presets für die tatsächliche Grundgestaltung. Eine registrierte Schriftfamilie lässt sich beispielsweise global anwenden:
"styles": {
"typography": {
"fontFamily": "var(--wp--preset--font-family--helvetica)"
}
}
Damit greifen Editor und Frontend auf dieselben benannten Gestaltungswerte zurück.
Ergebnis
Gestaltungswerkzeuge im Editor aus dem Theme bereitstellen
Die theme.json verbindet das Designsystem eines Themes mit den Werkzeugen im WordPress-Editor. Farben, Typografie, Abstände und Layoutwerte stehen dort als zentral gepflegte Auswahl bereit.
Presets zentral bereitstellen
Farben, Schriften, Abstände und Grössen stehen als benannte Werte im Editor bereit.
Werkzeuge sinnvoll begrenzen
Das Theme gibt für Rahmen, Abstände und Layout die Werkzeuge vor, die zum System gehören.
Blöcke differenziert konfigurieren
Einzelne Blöcke erhalten ergänzende Optionen, die ihre redaktionelle Gestaltung unterstützen.