theme.json: Firmenfarben und Schriften in WordPress zentral
Kurz gesagt: Wenn auf Ihrer WordPress-Website jede Überschrift ein etwas anderes Blau hat und Redakteure Schriftgrößen frei wählen, fehlt eine zentrale Vorgabe. In Block-Themes übernimmt die Datei theme.json diese Aufgabe. Dort legen Sie einmal die Firmenfarben, Schriften, Schriftgrößen und Inhaltsbreiten fest. WordPress macht daraus laut Block-Editor-Handbuch CSS-Variablen, die im Frontend und im Editor gleich wirken. Zusätzlich können Sie einschränken, welche freien Farb- und Größenwahlen im Editor überhaupt angeboten werden. Das Ergebnis: weniger Wildwuchs, einheitliche Seiten und Redakteure, die nur noch zwischen passenden Varianten wählen.
Das Problem: Gestaltung pro Block
Der Block-Editor erlaubt viel. Jeder Absatz kann eine eigene Farbe bekommen, jede Überschrift eine eigene Größe, jeder Button einen anderen Rundungsgrad. Was beim Bauen der ersten Seiten praktisch wirkt, wird nach einem Jahr zum Problem: Neue Mitarbeiterinnen kopieren Blöcke von alten Seiten, Farben werden nach Augenmaß nachgebaut, und beim nächsten Markenauftritt müssen Sie Dutzende Seiten einzeln anfassen.
Die Ursache ist fast immer dieselbe: Die Gestaltung steckt in den einzelnen Blöcken statt an einer zentralen Stelle.
Was theme.json leistet
Laut Handbuch wurde mit WordPress 5.8 ein Mechanismus eingeführt, mit dem ein Theme den Editor über eine Datei namens theme.json konfiguriert. Die Datei hat zwei Hauptbereiche:
- settings: Welche Gestaltungsmöglichkeiten der Editor anbietet und welche Vorgaben es gibt, etwa die Farbpalette, die Schriftgrößen und die Inhaltsbreite.
- styles: Wie die Website standardmäßig aussieht, etwa die Grundschrift, die Linkfarbe oder die Gestaltung bestimmter Blöcke.
Aus den Vorgaben, die das Handbuch Presets nennt, erzeugt WordPress CSS-Variablen. Eine Farbe mit dem Kürzel „primary“ wird zum Beispiel zur Variable --wp--preset--color--primary. Diese Variablen stehen im Frontend und im Editor zur Verfügung. Ändern Sie den Farbwert in der theme.json, ändert er sich überall, wo die Variable verwendet wird.
Schritt 1: Die Markenwerte sammeln
Bevor Sie etwas in die Datei schreiben, klären Sie mit der Person, die für den Auftritt verantwortlich ist:
- Welche Farben gehören zur Marke, und wofür wird jede verwendet? Hauptfarbe, Akzentfarbe, Hintergrund, Text.
- Welche Schriften sind vorgesehen, und liegen sie als Webfont-Dateien vor?
- Wie viele Schriftgrößen braucht die Website wirklich? Meist genügen wenige Stufen von klein bis sehr groß.
- Wie breit soll der normale Inhalt sein, und wie breit dürfen breite Elemente werden?
Vergeben Sie für jeden Wert einen sprechenden Namen. „Primär“ und „Akzent“ sind auf Dauer verständlicher als „Blau 2“.
Schritt 2: Vorgaben in theme.json eintragen
Die Werte gehören in den Bereich settings. Laut Handbuch gibt es dafür unter anderem:
- color.palette für die Farbpalette mit Name, Kürzel und Farbwert,
- typography.fontFamilies für die Schriftfamilien,
- typography.fontSizes für die Schriftgrößen,
- layout.contentSize und layout.wideSize für die Breiten.
Arbeiten Sie dabei in einem Child-Theme oder einem eigenen Theme, damit Ihre Änderungen bei einem Update des Ausgangs-Themes nicht verloren gehen.
Schritt 3: Freie Wahl im Editor einschränken
Der wichtigste Hebel gegen Wildwuchs ist das Abschalten freier Eingaben. Laut Handbuch steuern Einstellungen wie color.custom, color.defaultPalette oder typography.customFontSize, ob Redakteure eigene Farben und Größen wählen dürfen und ob die Standardpalette von WordPress zusätzlich erscheint.
Setzen Sie diese Werte auf false, sehen Redakteure nur noch Ihre Firmenfarben und die festgelegten Schriftgrößen. Das wirkt zunächst einschränkend, erleichtert aber die Arbeit: Niemand muss sich mehr fragen, welches Grün das richtige ist.
Die Einstellungen lassen sich laut Handbuch auch je Block festlegen. So können Sie etwa für Buttons nur zwei Farben erlauben, für Absätze aber die ganze Palette.
Schritt 4: Bestehende Seiten aufräumen
Eine neue theme.json ändert nicht automatisch Farben, die früher direkt in einzelne Blöcke geschrieben wurden. Gehen Sie deshalb die wichtigsten Seiten durch:
- Startseite, Leistungsseiten und Kontaktseite zuerst.
- Blöcke mit frei gewählten Farben auf die Palettenfarben umstellen.
- Wiederkehrende Elemente als Muster anlegen, damit sie künftig einheitlich bleiben.
Theme-Datei und Stile im Website-Editor
In Block-Themes können Administratoren zusätzlich im Website-Editor unter Stile Änderungen vornehmen. Diese Anpassungen werden in der Datenbank gespeichert und überlagern die Werte aus der Theme-Datei. Das ist praktisch für schnelle Anpassungen, kann aber verwirren: Wer später die theme.json ändert, sieht keine Wirkung, weil eine Einstellung im Website-Editor sie überdeckt. Legen Sie deshalb fest, wo Änderungen gepflegt werden, und dokumentieren Sie das.
Typische Fehler
- Zu viele Farben in der Palette: Wer alle jemals verwendeten Töne aufnimmt, hat das Problem nur verschoben. Halten Sie die Palette klein.
- Kürzel nachträglich ändern: Blöcke speichern das Kürzel einer Palettenfarbe. Benennen Sie „primary“ später um, verlieren bestehende Blöcke die Zuordnung. Ändern Sie lieber den Farbwert und lassen Sie das Kürzel stehen.
- Schriften ohne Dateien: Eine Schriftfamilie in der theme.json bewirkt nichts, wenn die passenden Schriftdateien nicht eingebunden sind. Prüfen Sie im Browser, ob tatsächlich die gewünschte Schrift geladen wird.
- Keine Testumgebung: Änderungen an der Datei wirken sofort auf der ganzen Website. Testen Sie sie zuerst auf einer Kopie.
- Keine Dokumentation: Halten Sie in einer kurzen Notiz fest, welche Farbe wofür gedacht ist. Neue Teammitglieder und externe Dienstleister finden sich damit schneller zurecht.
Ein Beispiel zur Veranschaulichung
Frei erfunden: Ein Ingenieurbüro mit Standorten in Bregenz, Konstanz und St. Gallen hat über die Jahre Seiten mit sieben verschiedenen Blautönen angesammelt. Die Agentur legt in der theme.json drei Firmenfarben und vier Schriftgrößen fest und schaltet freie Farben ab. Danach stellt eine Mitarbeiterin die zwanzig wichtigsten Seiten auf die Palette um. Beim nächsten Wechsel der Akzentfarbe genügt eine Änderung in der Datei.
Häufige Fragen
Funktioniert theme.json auch mit klassischen Themes?
Auch klassische Themes können eine theme.json mitbringen, um Einstellungen des Block-Editors zu steuern. Den vollen Umfang mit Website-Editor bieten Block-Themes.
Gehen meine Farben verloren, wenn ich freie Farben abschalte?
Bereits vergebene Farben bleiben in den Blöcken gespeichert. Sie können nur nicht mehr neu gewählt werden. Deshalb lohnt sich das Aufräumen bestehender Seiten.
Brauche ich dafür Programmierkenntnisse?
Die Datei ist im JSON-Format und gut lesbar. Ein Grundverständnis für die Struktur und eine Testumgebung sind aber empfehlenswert, da ein Tippfehler die Einstellungen unwirksam machen kann.
Warum ändert sich nach dem Bearbeiten der Datei nichts?
Häufig überdeckt eine Einstellung aus dem Website-Editor unter Stile den Wert aus der Datei. Prüfen Sie dort, ob für Farben oder Schriften eigene Werte hinterlegt sind, und setzen Sie diese bei Bedarf zurück. Auch ein Zwischenspeicher im Browser oder beim Hoster kann alte Werte noch kurz anzeigen.
Wenn Ihre Website einheitlicher werden soll und Redakteure weniger raten müssen, richten wir die zentralen Vorgaben gern mit Ihnen ein: Gestaltung vereinheitlichen.