WordPress-Block mit ungültigem Inhalt: ohne Textverlust lösen
Kurz gesagt: Die Meldung „Dieser Block enthält unerwarteten oder ungültigen Inhalt“ erscheint, wenn der Block-Editor einen gespeicherten Block nicht mehr so nachbauen kann, wie er in der Datenbank steht. Ihr Text ist in diesem Moment nicht verloren. Gefährlich wird es erst, wenn Sie vorschnell klicken und speichern. Prüfen Sie zuerst, was sich geändert hat, legen Sie eine Kopie des Inhalts an und wählen Sie dann bewusst zwischen Blockwiederherstellung, Umwandlung in HTML oder in einen klassischen Block. Tritt die Meldung auf vielen Seiten gleichzeitig auf, liegt die Ursache meist bei einem Plugin- oder Theme-Update, nicht bei Ihren Inhalten.
Was der Editor da eigentlich prüft
Jeder Block wird in WordPress als HTML mit kleinen Kommentar-Markierungen gespeichert. Beim Öffnen einer Seite liest der Editor diese Markierungen und die darin gespeicherten Eigenschaften. Laut Block-Editor-Handbuch erzeugt er dann aus diesen Eigenschaften das HTML neu und vergleicht es mit dem, was gespeichert ist. Stimmen beide nicht überein, markiert er den Block als ungültig.
Der Gedanke dahinter: Solange niemand etwas bearbeitet hat, müsste das neu erzeugte HTML genau dem gespeicherten entsprechen. Weicht es ab, könnte ein unbedachtes Speichern Inhalte verändern oder abschneiden. Die Warnung ist also eine Schutzfunktion und kein Zeichen dafür, dass schon etwas kaputt ist.
Die häufigsten Ursachen
Das Handbuch nennt zwei Hauptquellen:
- Geänderter Code eines Blocks: Ein Plugin, das eigene Blöcke mitbringt, ändert mit einem Update die Art, wie es seine Blöcke speichert. Ältere Inhalte passen dann nicht mehr zum neuen Speicherformat, sofern der Entwickler keine Übergangsregeln (im Fachjargon Deprecations) hinterlegt hat.
- Von außen bearbeitetes HTML: Jemand hat den Code des Blocks im Code-Editor, über eine Import-Funktion, ein Suchen-und-Ersetzen-Werkzeug oder eine Schnittstelle verändert, sodass er nicht mehr dem erwarteten Aufbau entspricht.
In der Praxis kommen noch einige Begleitumstände dazu: Inhalte, die aus einem anderen System kopiert wurden, Seitenbaukästen, die zusätzlich in den Inhalt schreiben, oder ein Plugin, das deaktiviert wurde und dessen Blöcke der Editor nun nicht mehr kennt. Im letzten Fall sehen Sie meist eine andere Meldung, nämlich dass der Block nicht unterstützt wird.
Bevor Sie klicken: Inhalt sichern
Speichern Sie die Seite nicht, solange Sie nicht wissen, was passiert ist. Gehen Sie so vor:
- Öffnen Sie über das Drei-Punkte-Menü oben rechts den Code-Editor und kopieren Sie den gesamten Inhalt in eine Textdatei.
- Prüfen Sie unter „Revisionen“ in der Seitenleiste, ob es eine ältere Fassung gibt, in der der Block noch einwandfrei war.
- Notieren Sie, welche Plugins oder Themes zuletzt aktualisiert wurden. Ein Blick in die Update-Historie Ihres Hosters oder in ein Aktivitätsprotokoll hilft dabei.
Mit dieser Kopie können Sie jede der folgenden Optionen ausprobieren, ohne etwas zu riskieren.
Die vier Optionen im Editor
Laut Handbuch bietet der Editor bei einem ungültigen Block diese Wege an:
- Blockwiederherstellung versuchen: Der Editor versucht, den Block so weit wie möglich wiederherzustellen. Das gelingt oft bei kleinen Abweichungen, etwa einer fehlenden Klasse. Kontrollieren Sie danach in der Vorschau, ob Texte, Links und Bilder vollständig sind.
- In HTML umwandeln: Das gespeicherte Markup bleibt erhalten, der Block wird zu einem HTML-Block. Sie verlieren die gewohnten Bedienelemente, aber nichts vom Inhalt.
- In Blöcke umwandeln: Der Editor versucht, aus dem gespeicherten Markup gültige Blöcke zu machen.
- In einen klassischen Block umwandeln: Der Inhalt bleibt, wie er ist, lässt sich aber nur noch im klassischen Editorfeld bearbeiten.
Für einzelne Blöcke ist „Blockwiederherstellung versuchen“ meist der erste Schritt. Bei komplexen Blöcken mit Spalten, Tabellen oder Galerien ist die Umwandlung in HTML oft der sicherere Zwischenschritt, bis die eigentliche Ursache behoben ist.
Wenn viele Seiten betroffen sind
Erscheint die Meldung plötzlich auf vielen Seiten und immer beim gleichen Blocktyp, etwa bei allen Preistabellen oder allen Akkordeons, dann sollten Sie die Inhalte nicht Seite für Seite reparieren. Die Ursache sitzt dann im Plugin, das diesen Block liefert.
- Prüfen Sie im Änderungsprotokoll des Plugins, ob das letzte Update das Speicherformat verändert hat.
- Testen Sie auf einer Kopie der Website, ob die Meldung mit der vorherigen Plugin-Version verschwindet.
- Melden Sie das Problem dem Plugin-Entwickler mit einem Beispiel des gespeicherten Codes. Fehlende Übergangsregeln lassen sich nur dort sauber nachrüsten.
Fragen Sie auch nach, ob andere Kunden das gleiche Verhalten melden. Häufig finden Sie im Support-Forum des Plugins bereits einen Hinweis auf eine geplante Korrektur oder eine empfohlene Zwischenlösung.
Bis eine korrigierte Version da ist, können Sie die Seiten meist unverändert lassen. Im Frontend wird das gespeicherte HTML weiter ausgeliefert, die Warnung betrifft nur den Editor. Prüfen Sie das aber auf einigen Seiten, statt es anzunehmen.
Ein Beispiel zur Veranschaulichung
Frei erfunden: Ein Kölner Fahrschulbetrieb pflegt seine Kursseiten selbst. Nach einem Update des Plugins für Preistabellen zeigen zwölf Seiten die Warnung. Die Büroleiterin klickt auf der ersten Seite auf „In Blöcke umwandeln“, speichert und stellt fest, dass die Hervorhebung des beliebtesten Pakets fehlt. Sie stellt die Revision wieder her, lässt die übrigen Seiten unangetastet und meldet das Problem dem Plugin-Anbieter. Zwei Tage später kommt eine Version mit Übergangsregeln, und die Warnungen verschwinden ohne weitere Handgriffe.
So beugen Sie vor
- Bearbeiten Sie Block-Inhalte möglichst im visuellen Editor statt im Code.
- Führen Sie Massenänderungen am Inhalt, etwa per Suchen und Ersetzen, zuerst auf einer Testkopie durch.
- Aktualisieren Sie Plugins mit eigenen Blöcken nicht alle gleichzeitig, damit Sie eine Ursache zuordnen können.
- Halten Sie Revisionen aktiviert, damit Sie zu einer funktionierenden Fassung zurückkehren können.
Häufige Fragen
Ist mein Text weg, wenn die Meldung erscheint?
Nein. Der gespeicherte Inhalt bleibt in der Datenbank, bis Sie die Seite mit einer veränderten Fassung speichern. Deshalb lohnt sich die Kopie aus dem Code-Editor vor jedem Klick.
Sehen Besucher die Fehlermeldung?
Die Meldung erscheint nur im Editor. Ob die Seite für Besucher richtig aussieht, prüfen Sie in der normalen Ansicht der Website.
Warum hilft „Blockwiederherstellung versuchen“ manchmal nicht?
Wenn sich das Speicherformat eines Blocks grundlegend geändert hat, kann der Editor die Abweichung nicht selbst auflösen. Dann braucht es eine Übergangsregel im Plugin oder eine Umwandlung in HTML.
Soll ich das Plugin zurück auf die alte Version setzen?
Das kann eine Übergangslösung sein, wenn Sie es vorher auf einer Kopie testen. Langfristig sollte der Entwickler das neue Format mit Übergangsregeln für alte Inhalte versehen.
Wenn Sie nach einem Update ungültige Blöcke auf vielen Seiten sehen, finden wir die Ursache gern gemeinsam, bevor jemand speichert: Block-Problem schildern.