Bard in Statamic konfigurieren: Buttons, Sets und Grenzen
Konfigurieren Sie Bard so, dass Redakteure nur die Formatierungen sehen, die das Design trägt. Alles mit festem Aufbau, etwa Bilder, Hinweisboxen oder Tabellen, gehört in Bausteine mit eigenen Feldern: als Set im Editor oder als Block in einem Page-Builder. Das hält eine Website über Jahre einheitlich.
Bard ist der Texteditor von Statamic. Er speichert Inhalte nicht als HTML, sondern als strukturierte Daten im Format von ProseMirror, und kann neben formatiertem Text eigene Bausteine aufnehmen, die Sets. Wie viel Freiheit Redakteure darin haben, legen Sie im Blueprint oder in einem Fieldset fest, Feld für Feld. Alle Angaben in diesem Beitrag beziehen sich auf Statamic 6, das am 28.01.2026 erschienen ist. Als Beispiel dient die Konfiguration dieser Website, die wir als Statamic-Entwickler selbst gebaut haben und die auf Statamic 6.39 läuft.
Grundsatz
Wenige Buttons, feste Bausteine
Jeder Button in der Werkzeugleiste ist eine Formatierung, die ein Redakteur frei anwenden kann. Jeder Baustein mit eigenen Feldern ist dagegen eine Form, die das Design kontrolliert. Je mehr ein Inhalt nach festen Regeln aussehen soll, desto eher gehört er in einen Baustein.
Ein Beispiel: Eine Hinweisbox mit Rahmen und Symbol lässt sich mit Buttons nicht sauber bauen. Redakteure greifen dann zu Fett, Kursiv und einer Tabelle mit einer Zelle. Als Baustein mit den Feldern Typ, Überschrift und Text sieht jede Hinweisbox gleich aus, und ein späteres Redesign ändert alle auf einmal.
Für die Bausteine gibt es in Statamic zwei Wege. Sets stehen innerhalb eines Bard-Felds zwischen den Absätzen. Ein Page-Builder, technisch ein Replicator-Feld, reiht dagegen ganze Abschnitte aneinander, von denen jeder sein eigenes kleines Bard-Feld haben kann. Diese Website nutzt den zweiten Weg, deshalb kommt ihr Bard-Feld ohne Sets aus.
Buttons
Bard-Buttons gezielt freischalten
Statamic 6 bietet unter anderem diese Buttons an: h1 bis h6, bold, italic, underline, strikethrough, small, superscript, subscript, code, codeblock, quote, unorderedlist, orderedlist, anchor, image, table, horizontalrule, removeformat sowie vier Buttons für die Textausrichtung. Sie werden in der Feldkonfiguration unter buttons als Liste angegeben.
Das Bard-Feld, das auf dieser Website in den meisten Blöcken des Page-Builders den Text trägt, ist so konfiguriert (gekürzt um Anzeigename und Hilfetext):
handle: content
field:
type: bard
localizable: true
buttons:
- h2
- h3
- h4
- bold
- unorderedlist
- orderedlist
- anchor
- removeformat
reading_time: false
remove_empty_nodes: true
smart_typography: false
container: files
Die Auswahl hat Gründe, die sich aus dem Aufbau der Seiten ergeben. Kein h1, weil die Hauptüberschrift im Hero-Block steht und eine Seite nur eine H1 haben soll. Kein underline, weil Unterstreichungen im Web wie Links aussehen. Kein image, table und codeblock, weil Bilder, Vergleichstabellen und Code eigene Blöcke im Page-Builder haben, mit Feldern für Alternativtext, Dateiname oder Sprache. Kursiv fehlt in diesem Feld, ist in zwei anderen Bard-Feldern derselben Website aber freigeschaltet: Die Auswahl gilt je Feld, nicht für die ganze Website.
Einstellungen
Weitere Optionen in Statamic 6
Neben den Buttons hat Bard eine Reihe von Einstellungen, die das Verhalten im Alltag bestimmen:
toolbar_mode: fixed zeigt die Leiste dauerhaft oben, floating erst beim Markieren von Text. Standard ist fixed.
remove_empty_nodes: entfernt leere Absätze, die beim Bearbeiten entstehen und sonst als Lücken auf der Seite landen. Mögliche Werte sind false, true und trim, der Standard ist false.
smart_typography: setzt typografische Anführungszeichen und Striche beim Tippen. Wer lange Striche im Text vermeiden will, lässt die Option aus.
link_collections: begrenzt, auf welche Collections der Link-Dialog verweisen darf. Dazu kommen link_noopener, link_noreferrer und target_blank für Links nach außen.
inline: macht aus Bard ein einzeiliges Feld ohne Absätze. In Statamic 6 ist das ein Schalter, Zeilenumbrüche erlaubt zusätzlich inline_hard_breaks.
character_limit, reading_time und word_count: begrenzen die Länge oder zeigen Lesezeit und Wortzahl unter dem Editor.
Wer von Statamic 5 kommt, findet eine Option nicht mehr: allow_source. Sie öffnete Redakteuren den HTML-Quelltext und stand standardmäßig auf true. Im Bard-Feldtyp von Statamic 6 gibt es sie nicht mehr. Steht sie noch in einem alten Blueprint oder Fieldset, wird sie ignoriert und kann beim nächsten Aufräumen entfernt werden.
Sets
Sets für Bilder, Zitate und Hinweise
Sets sind Bausteine mit eigenen Feldern, die Redakteure über ein Plus-Symbol zwischen die Absätze setzen. Sie passen zu langen Texten, in denen Bilder oder Hinweise mitten im Lesefluss stehen, etwa in einem Magazin.
Sets, die in vielen Projekten vorkommen:
Bild: Asset, Alternativtext als Pflichtfeld, Bildunterschrift, Breite aus einer festen Auswahl.
Zitat: Text, Name, Funktion. Kein freies Formatieren.
Hinweis: Typ aus einer Auswahl (Info, Warnung, Tipp), Überschrift, kurzer Text.
Video: Adresse und Vorschaubild, damit kein fremder Player ohne Einwilligung lädt.
Neu in Statamic 6 sind Vorschaubilder im Auswahlmenü der Sets, damit Redakteure nicht raten müssen, was „Callout B“ ist. Die Vorschaubilder brauchen einen Ablageort, der in config/statamic/assets.php unter set_preview_images mit Container und Ordner eingetragen wird; ohne diesen Eintrag erscheint das Feld für das Vorschaubild nicht. Auf dieser Website zeigt der Eintrag auf einen eigenen Container für die Blöcke des Page-Builders. Benennen Sie Sets nach dem, was der Redakteur sieht, nicht nach dem Namen der Komponente im Code.
Eine Einschränkung betrifft die Option save_html, die Bard-Inhalte als fertiges HTML statt als strukturierte Daten speichert: Sie funktioniert nur, solange keine Sets definiert sind. Wer sie am Anfang aktiviert und später Sets braucht, muss bestehende Inhalte umwandeln.
Erweiterungen
Eigene Erweiterungen für Bard
Reichen Buttons und Sets nicht, lässt sich Bard erweitern. Unter der Oberfläche arbeitet der Editor Tiptap, und Statamic stellt dafür eine JavaScript-Schnittstelle bereit: Mit Statamic.$bard.addExtension kommen neue Tiptap-Erweiterungen hinzu, mit Statamic.$bard.buttons neue Buttons in der Werkzeugleiste, mit Statamic.$bard.replaceExtension lassen sich eingebaute Erweiterungen umkonfigurieren. Erzeugt eine Erweiterung neue Arten von Inhalt, braucht sie für die Ausgabe auf der Website ein Gegenstück in PHP, das über Augmentor::addExtension registriert wird.
Ein Beispiel ist unser Addon Bard FontSizes. Es ergänzt Buttons für Textgrößen, deren Stufen in der Konfiguration festgelegt werden, zum Beispiel drei für eine kleine Website oder sieben für ein Magazin. Die Buttons setzen Klassen, die auf die Typografie-Stufen von Tailwind CSS zeigen. Redakteure bekommen damit eine kontrollierte Wahl statt freier Schriftgrößen.
Eine Erweiterung braucht bei jedem größeren Update von Statamic oder Tiptap eine Prüfung. Klären Sie deshalb vorher, ob ein Set dieselbe Aufgabe erfüllt. Wie ein eigener Feldtyp für das Control Panel entsteht, zeigt der Beitrag Inertia + Vue 3 + Statamic CP: Custom Fieldtype in 30 Minuten.
Fehler
Fehlkonfigurationen und ihre Folgen
Die meisten Probleme mit Bard entstehen nicht im Editor, sondern Monate später auf der Website, wenn Redakteure die Freiheiten nutzen, die man ihnen gelassen hat. Diese Muster haben jeweils eine absehbare Folge:
Alle Buttons aktiv: Überschriften werden zur Hervorhebung genutzt, die Gliederung für Suchmaschinen und Screenreader stimmt nicht mehr.
h1 im Editor: zwei oder mehr H1 auf einer Seite.
Bilder als Button statt als Baustein: Bilder ohne Alternativtext und in Originalgröße.
Absolute Links auf die eigene Website: Redakteure kopieren Adressen aus dem Browser, die nach einer Domain- oder Slug-Änderung ins Leere führen. Der Link-Dialog von Bard kann stattdessen auf Einträge verweisen, gespeichert als statamic://entry:: mit der ID. Solche Links bleiben gültig, wenn sich die Adresse ändert.
HTML-Einbettungen ohne Regeln: Wer Skripte oder iframes von Drittanbietern braucht, baut dafür einen Baustein mit festen Feldern, der die Einwilligung prüft, statt sie als freien Code zuzulassen.
Welche Personen später mit welchen Rechten im Editor arbeiten, gehört zu den Fragen, die Sie vor einem neuen Projekt klären, wie im Beitrag CMS-Workshop vorbereiten beschrieben. Davon hängt ab, wie eng die Buttons gefasst werden.
Kurz beantwortet
Häufige Fragen
-
Markdown speichert Text mit wenigen Sonderzeichen für Formatierungen und eignet sich für Entwickler und kurze Texte. Bard ist ein visueller Editor, speichert strukturierte Daten und kann Sets zwischen die Absätze setzen. Für Redakteure ohne technischen Hintergrund ist Bard in den meisten Projekten die bessere Wahl.
-
Über Sets, die Entwickler im Blueprint anlegen und gestalten. Redakteure wählen das Set aus und füllen die Felder, die Darstellung bestimmt das Template. Sets passen zu langen Texten, in denen Bilder und Hinweise im Lesefluss stehen. Ein Page-Builder passt zu Seiten, die aus klar getrennten Abschnitten mit eigenem Layout bestehen, etwa Landingpages. Beides lässt sich kombinieren, dann sollte aber feststehen, welche Bausteine wohin gehören.
-
Die gespeicherten Einträge ändert die neue Konfiguration nicht, die alten Formatierungen stehen weiter in den Dateien oder in der Datenbank. Wie der Editor und die Website sie danach behandeln, prüfen Sie an einer Kopie: Öffnen Sie einige betroffene Einträge, speichern Sie sie und vergleichen Sie die Ausgabe. Wer alte Formatierungen ganz loswerden will, braucht ein kleines Skript, das die Inhalte durchgeht und sie umwandelt.
Bard-Erweiterung im Einsatz
Bard FontSizes ergänzt den Editor um Textgrößen, die zu Ihrem Design-System passen, für Statamic Free und Pro.
Nachweise
Quellen und Stand
Geprüft am 02.11.2026: Optionen, Standardwerte und Buttons gegen den Quellcode von Statamic 6.39 und die Dokumentation zu Statamic 6, die frühere Option allow_source gegen die Dokumentation zu Statamic 5, Konfiguration dieser Website laut Repository.
Artikel teilen