„Dieser Block enthält unerwartete oder ungültige Inhalte“: So retten Sie den Beitrag

Wenn im Block-Editor plötzlich die Meldung „Dieser Block enthält unerwartete oder ungültige Inhalte“ erscheint, ist der erste Impuls meist Panik — der Beitrag sieht kaputt aus. Tatsächlich ist der Text in praktisch allen Fällen noch vollständig da. WordPress hat nur festgestellt, dass der gespeicherte HTML-Code eines Blocks nicht mehr zu dem passt, was die aktuelle Blockdefinition daraus erzeugen würde, und zeigt deshalb eine Warnung statt der Vorschau.

Woran das liegt

Die Ursache finde ich in dieser Reihenfolge, weil die ersten beiden Fälle mit Abstand am häufigsten sind:

• Ein Plugin- oder Theme-Update hat die Blockdefinition geändert. Divi, Elementor, Yoast, aber auch reine Gutenberg-Erweiterungen verändern mit neuen Versionen manchmal die Attribute oder das Markup eines Blocks. Alte Beiträge wurden mit der vorherigen Definition gespeichert und validieren jetzt nicht mehr.
• Jemand hat den HTML-Code im Editor von Hand angepasst — über den Code-Editor-Modus eines Blocks oder beim Einfügen aus Word oder einer anderen Website, wobei überflüssige Tags oder Attribute mitkamen.
• Ein Plugin wurde deaktiviert oder gelöscht, das einen eigenen Blocktyp bereitgestellt hat. WordPress kennt den Block dann gar nicht mehr und kann ihn folglich auch nicht mehr validieren.
• Die Website lief auf einem anderen WordPress- oder PHP-Stand, als der Inhalt entstand, und die Blockversion hat sich seitdem mehrfach weiterentwickelt.

In allen vier Fällen bleibt der eigentliche Inhalt unangetastet in der Datenbank-Spalte post_content stehen. Der Editor zeigt nur eine Warnung an, weil er sich nicht sicher ist, ob die Vorschau noch korrekt wäre.

Die Lösung Schritt für Schritt

Im Editor erscheint neben der Fehlermeldung ein Menü mit drei Punkten. Dort stehen zwei Optionen zur Wahl, und die Reihenfolge, in der ich sie ausprobiere, ist wichtig:

1. „Block wiederherstellen versuchen“ zuerst. WordPress rendert den gespeicherten HTML-Code dann direkt, ohne ihn gegen die aktuelle Blockdefinition zu prüfen. In den meisten Fällen erscheint der Block danach wieder genauso wie vorher, und die Warnung verschwindet beim nächsten Speichern von selbst, weil der Block jetzt mit der neuen Definition übereinstimmt.
2. Klappt das nicht und der Block sieht sichtbar zerstört aus, hilft „Als HTML bearbeiten“ im selben Menü. Damit öffnet sich der rohe Code des Blocks, und ich kann das störende Zeichen oder Attribut gezielt entfernen, statt den ganzen Abschnitt neu zu schreiben.
3. Bevor ich eine der beiden Optionen nutze, sichere ich den Beitrag immer über „Als HTML kopieren“ im gleichen Menü in die Zwischenablage. Das kostet zehn Sekunden und verhindert, dass bei einem Fehlgriff etwas verloren geht.
4. Betrifft die Meldung mehrere Beiträge gleichzeitig und das Muster ist immer dasselbe Plugin, lohnt sich ein Blick in dessen Änderungsprotokoll („Changelog“) zur aktuellen Version — oft steht dort ausdrücklich, dass sich ein Blockformat geändert hat, und eine ältere Pluginversion lässt sich zur Not vorübergehend wieder einspielen.

Erscheint die Meldung bei einem Block, den ein mittlerweile deaktiviertes Plugin bereitgestellt hat, bringt Wiederherstellen allein nichts — WordPress kennt den Blocktyp schlicht nicht mehr. Dann entweder das Plugin reaktivieren oder den Inhalt per „Als HTML bearbeiten“ in einen Standardblock wie einen Absatz oder eine Spalte überführen.

Was danach zu prüfen ist

Nach der Wiederherstellung öffne ich den Beitrag einmal in der Live-Vorschau, nicht nur im Editor — manche Abweichungen zeigen sich erst im tatsächlichen Theme-Layout, etwa bei Abständen oder Spaltenbreiten. Erst wenn die Vorschau passt, speichere ich den Beitrag final ab, damit die reparierte Version in der Datenbank landet und die Warnung nicht beim nächsten Öffnen erneut auftaucht.

Wie man es künftig vermeidet

Ganz verhindern lässt sich das Problem nicht, weil es an Plugin- und Theme-Updates hängt, die man ja aus Sicherheitsgründen einspielen sollte. Zwei Gewohnheiten senken das Risiko deutlich: Updates zuerst auf einer Staging-Kopie der WordPress-Website testen, bevor sie live gehen, und Inhalte nicht direkt aus Word oder PDF einfügen, sondern über „Reinen Text einfügen“ (meist per Tastenkombination beim Einfügen), damit kein fremdes Markup mitkommt. Wer ohnehin regelmäßig mit solchen Fehlermeldungen zu tun hat, sollte grundsätzlich prüfen, ob die Plugin-Anzahl im Projekt noch zum tatsächlichen Bedarf passt — jedes zusätzliche Plugin ist eine zusätzliche Fehlerquelle bei künftigen Updates.

Kurz beantwortet

Ist der Inhalt bei dieser Meldung wirklich noch da?

Ja. Die Meldung betrifft nur die Vorschau im Editor, nicht die gespeicherten Daten — gelöscht wird dabei nichts.

Welche Option sollte ich zuerst ausprobieren?

Immer zuerst „Block wiederherstellen versuchen“. Das reicht in den meisten Fällen, ohne dass Sie Code anfassen müssen.

Was tun, wenn der Block von einem gelöschten Plugin stammt?

Plugin reaktivieren oder den Inhalt per „Als HTML bearbeiten“ in einen Standardblock wie Absatz oder Spalte übertragen.