Einen ungültigen WordPress-Block reparieren und den Originalinhalt erhalten

Die Meldung erkennen und den betroffenen Bereich eingrenzen

Der Editor meldet, dass ein Block unerwarteten oder ungültigen Inhalt enthält. Der Text oder das Bild ist auf der öffentlichen Website manchmal noch zu sehen, obwohl sich der Block nur schwer bearbeiten lässt. Ziel ist es, den vollständigen Inhalt zurückzugewinnen und ihn wieder bearbeiten und korrekt speichern zu können. Prüfe deshalb das Ergebnis, sobald die Warnung verschwunden ist.

Bei manchen Blöcken vergleicht WordPress die gespeicherte Struktur mit der Struktur, die der Block erzeugen kann. Abweichungen können die Validierung auslösen, etwa nach einer manuellen Änderung am HTML, einem ungewöhnlichen Einfügevorgang oder einer Änderung an der Komponente, die den Block bereitstellt. HTML ist die Auszeichnung, die die Elemente einer Seite beschreibt. Die Meldung allein reicht für die Diagnose einer beschädigten Datenbank nicht aus.

Eine ungültige JSON-Antwort beim Speichern betrifft den Austausch mit dem Server. Wenn sie ebenfalls angezeigt wird, sichere deine Arbeit und lass das Problem gesondert untersuchen. Ein nicht verfügbarer Block, eine Sperre und ein JavaScript-Fehler erfordern ebenfalls jeweils eine eigene Diagnose.

Vor der Wiederherstellung eine Kopie sichern

Halte den Zugriff auf das Originaldokument offen und bereite eine lokale Textdatei sowie einen separaten Entwurf vor. Diese Kopie schützt den Inhalt während der Versuche. Für Eingriffe, die über das Dokument hinausgehen, brauchst du eine Sicherung der Website.

1. Lass den ursprünglichen Tab geöffnet. Suche im Hauptmenü des Editors nach dem Befehl zum Kopieren des gesamten Inhalts. Füge das Ergebnis in die lokale Datei ein. Prüfe, ob Anfang, Ende und der betroffene Teil enthalten sind, bevor du die Kopie als Grundlage verwendest.
2. Wenn sich der gesamte Inhalt nicht kopieren lässt, wähle den betroffenen Block aus und suche in seinem Drei-Punkte-Menü nach **Kopieren**. Sichere zugängliche Texte, Medienadressen und einen Screenshot des Layouts separat. Ein Screenshot hilft, das Aussehen nachzubauen. Die Einstellungen interaktiver Elemente und die Blockstruktur müssen aus dem gesicherten Inhalt wiedergewonnen werden.
3. Erstelle unter **Beiträge** oder **Seiten** einen neuen Arbeitsentwurf. Füge den Inhalt dort ein und prüfe vor einem Versuch, ob du dich tatsächlich im neuen Dokument befindest. Lass es als Entwurf gespeichert, damit Besucher weiter das Original sehen. Medien und Website-Komponenten werden weiterhin gemeinsam genutzt.
4. Bewahre die erste Datei auf und speichere umgewandelte Fassungen getrennt. Gib jeder Testfassung einen eigenen Namen. Du solltest den Ausgangstext auch dann wiederfinden können, wenn der Entwurf unbrauchbar geworden ist. Behalte die Kopie als Absicherung zusätzlich zur Rückgängig-Funktion des Editors.
5. Lass vor einem Plugin-Update oder einem größeren Eingriff bestätigen, dass Datenbank und Dateien gesichert sind und wie sie sich wiederherstellen lassen. Wenn diese Absicherung fehlt, unterbrich Änderungen an den Komponenten. Mit einer Textkopie lässt sich weder ein Plugin noch seine Konfiguration wiederherstellen.

Berechtigungen prüfen und den Geltungsbereich des Blocks klären

Du brauchst die Berechtigung, den betroffenen Inhalt zu bearbeiten. Eingriffe an Plugins erfordern eigene Rechte. Notiere die WordPress-Version, das Theme, den Namen des Blocks und die letzte Änderung vor dem Fehler. Halte auch fest, ob du selbst gehostetes WordPress, WordPress.com oder ein Multisite-Netzwerk verwendest. Der Hosting-Zugang und die verfügbaren Menüs unterscheiden sich je nach Umgebung.

Öffne die **Listenansicht** über die Dokumentübersicht oben im Editor. Klappe die Gruppe mit dem Block auf und ermittle seine genaue Position. Wenn du versehentlich die ganze Gruppe auswählst, kann die Umwandlung weit mehr Inhalt betreffen als den gewünschten Absatz.

Prüfe, ob der Inhalt zu einem synchronisierten Pattern gehört, früher auch wiederverwendbarer Block genannt. Eine Änderung am Original kann alle Instanzen betreffen. Auch eine Kopie der Seite kann weiter mit demselben Original verbunden sein. Löse die Verbindung für den lokalen Versuch, falls der Befehl angeboten wird und du dazu berechtigt bist. Andernfalls bitte die zuständige Person um Unterstützung, bevor du fortfährst.

Zwischen den drei Vorgehensweisen wählen

Beginne mit einer gezielten Wiederherstellung, wenn nach einer Inhaltsänderung nur ein einzelner Block die Meldung zeigt. Vergleiche die kleine Korrektur mit deiner gesicherten Kopie und lass den Rest des Dokuments unverändert.

Nutze die Revisionen, wenn eine funktionierende Fassung bereits gespeichert wurde und du ihren Inhalt zurückholen möchtest. Das ist besonders hilfreich, wenn die Wiederherstellung wichtige Elemente entfernt. Eine Revision stellt gespeicherten Inhalt wieder her. Eine inkompatible Blockkomponente braucht eine eigene Korrektur.

Untersuche den Drittanbieterblock, wenn nach einem Update mehrere ältere Inhalte betroffen sind oder der Block von einem fehlenden Plugin abhängt. In diesem Fall kann eine Umwandlung auf jeder Seite die Ursache verdecken und Funktionen entfernen. Für alle drei Vorgehensweisen reichen die vorhandenen Werkzeuge aus.

Vorgehensweise 1: Die Wiederherstellung auf der Kopie versuchen

Verwende einen separaten Arbeitsentwurf und eine geprüfte Kopie außerhalb von WordPress. Diese Vorgehensweise eignet sich für einen einzelnen Block, dessen Anbieter noch verfügbar ist. Das erwartete Ergebnis ist ein vollständiger Inhalt, der nach dem Speichern bearbeitet werden kann.

1. Öffne die **Listenansicht** des Entwurfs, wähle nur den betroffenen Block aus und prüfe seine Position. Lass die Gruppe und die übrige Seite unangetastet. Eine erfolgreiche Wiederherstellung bei einem Absatz sagt wenig über eine Galerie oder einen Shop-Block aus.
2. Klicke in der Warnung einmal auf die Schaltfläche für die Wiederherstellung. Je nach Sprache und Version kann sie **Wiederherstellung versuchen** oder **Attempt Recovery** heißen. Vergleiche das Ergebnis sofort mit der ursprünglichen Datei und dem gesicherten Screenshot.
3. Prüfe Wörter, Links, Bilder und die benötigten Darstellungseinstellungen. Bei der Wiederherstellung kann nicht erkannte Auszeichnung entfallen. Wenn etwas fehlt, nutze **Rückgängig**, bevor du es erneut versuchst. Falls du den gewünschten Zustand nicht wiederfindest, beginne im Entwurf erneut mit der gesicherten Kopie.
4. Wenn der Inhalt vollständig aussieht, speichere den Entwurf, verlasse die Bearbeitung und öffne ihn erneut. Prüfe, ob der Block bearbeitbar bleibt und die Meldung ausbleibt. Beim erneuten Öffnen siehst du den gespeicherten Inhalt und kannst prüfen, ob die Änderung Bestand hat.
5. Halte fest, ob die Korrektur erhalten blieb oder der Fehler sofort, nach dem Speichern oder beim erneuten Öffnen zurückkam. Scheitert der Versuch, lass das Original unverändert und prüfe eine Umwandlung oder Revision wie in den folgenden Abschnitten beschrieben. Warte mit der Wiederherstellung auf weiteren Seiten, bis ein repräsentativer Block die Prüfung bestanden hat.

Eine Umwandlung prüfen, ohne Inhalt zu verlieren

Wenn die Wiederherstellung ungeeignet ist, öffne das Drei-Punkte-Menü der Warnung. Falls **Auflösen** oder eine entsprechende Funktion angeboten wird, vergleiche den vorhandenen Inhalt mit der erwarteten Fassung. Achte vor der Umwandlung in Blöcke darauf, welche Inhalte entfernt würden. Wenn du die Unterschiede nicht verstehst, verlasse den Vergleich, ohne die Umwandlung zu bestätigen.

Eine weitere Möglichkeit ist die Umwandlung in einen Block für **individuelles HTML**, vor allem wenn ein Ausschnitt der Auszeichnung zur Prüfung erhalten bleiben soll. Die Einstellungen des ursprünglichen Blocks stehen danach nicht im HTML-Block zur Verfügung. Die Methode eignet sich vor allem für jemanden, der das HTML prüfen kann. Für Anfänger kann es leichter sein, einen einfachen Absatz in einem WordPress-eigenen Block neu aufzubauen und zu pflegen.

Vermeide unbekannten Code, um die Meldung zu beseitigen. Je nach Berechtigungen und Umgebung kann WordPress beim Speichern bestimmte HTML-Elemente herausfiltern. Prüfe das Ergebnis daher erneut, selbst wenn die Vorschau vor dem Speichern korrekt aussah. Lass die Berechtigungen und die Filterung dabei unverändert.

Bleib für diesen Vergleich auf der Kopie. Wenn die Umwandlung Text entfernt, Links ändert oder den Inhalt durch einen leeren Block ersetzt, brich diesen Weg ab. Verwende das gesicherte Original, um den Block neu aufzubauen oder eine geeignete Revision zu finden.

Entscheiden, wann sich der klassische Block oder ein Neuaufbau eignet

Manche Oberflächen bieten die Umwandlung in den Block **Klassisch** an. Er ist in den Block-Editor integriert und stellt ähnliche Werkzeuge wie der frühere Editor bereit. Du kannst ihn verwenden, ohne das Plugin Classic Editor zu installieren oder den Editor für die ganze Website zu wechseln.

Probiere diese Umwandlung nur auf der Kopie aus, sofern die Option verfügbar ist. Prüfe, was erhalten blieb, bevor du eine weitere Änderung vornimmst. Die anschließende Umwandlung des klassischen Blocks in mehrere Blöcke ist ein weiterer Eingriff. Prüfe das Zwischenergebnis, bevor du diesen Schritt in Betracht ziehst.

Bei einfachen Inhalten kannst du neben dem fehlerhaften Block einen **Absatz**, eine **Überschrift** oder ein **Bild** einfügen. Übernimm den Text ohne die problematische Formatierung, erstelle die Links neu und wähle die Bilder aus der Mediathek aus. Vergleiche beide Fassungen, bevor du den fehlerhaften Block aus der Kopie entfernst. Wenn der neue Block nach erneutem Öffnen funktioniert, kannst du diese gezielte Korrektur in das Original übernehmen.

Vorgehensweise 2: Eine brauchbare Fassung in den Revisionen finden

Du brauchst eine vor dem Fehler gespeicherte Fassung und die Berechtigung, den Verlauf einzusehen. Sichere zuerst den aktuellen Stand außerhalb von WordPress. Eine vollständige Wiederherstellung kann neuere Änderungen ersetzen und eine veröffentlichte Seite sofort ändern.

1. Öffne im Originaldokument die Einstellungen, dann den Tab **Beitrag** oder **Seite** und den Bereich **Revisionen**. Prüfe je nach Version die visuelle Vorschau oder den HTML-Vergleich. Bestätige den Titel des Dokuments, bevor du die Datumsangaben durchgehst.
2. Wähle eine Fassung vor dem Auftreten des Problems aus, ohne auf **Wiederherstellen** zu klicken. Notiere den Autor, den Zeitpunkt und den benötigten Abschnitt. Automatische Sicherungen reichen nur begrenzt zurück. Ob sich ein Text wiederherstellen lässt, hängt davon ab, ob er gespeichert und aufbewahrt wurde.
3. Vergleiche auch die neueren Änderungen an anderen Stellen der Seite, die du behalten musst. Entnimm nach Möglichkeit nur den benötigten Block wie im nächsten Abschnitt beschrieben. Auf WordPress.com kann **Wiederherstellen** die Revision unmittelbar auf der öffentlichen Website einsetzen. Lass die für die Veröffentlichung zuständige Person über eine vollständige Wiederherstellung entscheiden.
4. Verlasse den Verlauf ohne vollständige Wiederherstellung, solange die Entscheidung aussteht. Am Ende dieser Suche solltest du eine eindeutige Fassung ausgewählt und den Umfang der Wiederherstellung festgelegt haben. Falls keine brauchbare Fassung vorliegt oder dir die Rechte für den Verlauf fehlen, gib diese Einschränkung an einen berechtigten Redakteur weiter.
5. Prüfe anschließend den wiedergewonnenen Ausschnitt im Entwurf. Falls du den falschen Abschnitt ausgewählt hast, lege diese Kopie beiseite und entnimm den richtigen Abschnitt aus dem gesicherten Stand. Wird derselbe Block nach dem erneuten Öffnen wieder ungültig, prüfe die Komponente. Mehrere ältere Revisionen zurückzuspielen behebt ihre Inkompatibilität nicht.

Einen Teil wiedergewinnen, ohne die ganze Seite zurückzusetzen

Wenn du im visuellen Verlauf einzelne Blöcke auswählen kannst, kopiere den benötigten Teil und verlasse den Verlauf ohne vollständige Wiederherstellung. Füge den Inhalt in den Arbeitsentwurf ein und prüfe ihn. Dieses Vorgehen ist für WordPress.com dokumentiert. In älteren Oberflächen können die verfügbaren Befehle abweichen.

Wenn du nur einen HTML-Vergleich hast, nutze ihn, um die gesuchte Stelle zu finden. Wähle vollständige Blöcke einschließlich der Grenzen etwaiger Gruppen aus. Lass den Ausschnitt bei Bedarf von jemandem entnehmen, der die Auszeichnung kennt, oder baue einfache Inhalte mit dem wiedergewonnenen Text neu auf.

Speichere die wiederhergestellte Kopie und öffne sie erneut. Wird derselbe Block wieder ungültig, reicht die frühere Fassung des Inhalts allein nicht aus. Die Ursache kann in der aktuellen Version der Komponente liegen. Gehe dann zur dritten Vorgehensweise über, bevor du weitere ältere Fassungen auf der öffentlichen Seite wiederherstellst.

Vorgehensweise 3: Die Komponente des Drittanbieterblocks ermitteln

Notiere zuerst die Versionen und den Blocknamen. Für Eingriffe an Plugins ist ein berechtigter Administrator erforderlich. Ein Drittanbieterblock stammt aus einem Plugin oder Theme. In diesem Schritt ermittelst du die Komponente, die den Block bereitstellt, bevor du eine Umwandlung oder Migration versuchst.

1. Notiere in der Warnung und in der **Listenansicht** den Namen des Blocks und, falls er angezeigt wird, seine technische Kennung. Bewahre ein möglichst kleines Beispiel ohne private Daten auf. Lass den Administrator die Kennung mit den installierten Komponenten abgleichen, bevor du Ersatz in Betracht ziehst.
2. Unterscheide zwei Fälle. Der Block ist noch vorhanden, aber sein älterer Inhalt besteht die Validierung nicht mehr. Oder WordPress meldet, dass der Block nicht unterstützt wird. Notiere im ersten Fall die Version des Anbieters und die jüngsten Updates. Prüfe im zweiten Fall, ob die Komponente deaktiviert ist, fehlt oder in dieser Umgebung nicht zur Verfügung steht.
3. Lass die fehlenden Blöcke während der Bestandsaufnahme stehen. Eine Umwandlung in HTML kann einen Teil des Inhalts bewahren, stellt jedoch die Funktionen des Blocks nicht wieder her. Bitte bei Multisite den Netzwerkadministrator, netzwerkweit verwaltete Komponenten zu prüfen. Nutze bei WordPress.com die verfügbaren Zugänge oder den Support.
4. Ziel ist es, die Komponente zu identifizieren und eine konkrete Vermutung zu formulieren, die du wie unten beschrieben auf einer getrennten Kopie prüfen kannst. Bleibt unklar, welche Komponente den Block liefert, unterbrich die Bearbeitung und gib den Blocknamen und die Versionen weiter. Die Bestandsaufnahme erfolgt lesend. Bewahre das Original für die folgenden Versuche auf.

Vor einer Migration prüfen, ob eine Inkompatibilität vorliegt

Lass eine Testumgebung mit eigener Datenbank und einer Sicherung vorbereiten. Stelle sicher, dass echte Zahlungen, Benachrichtigungen und ausgehende Nachrichten dort deaktiviert sind. Wenn ein Update und der Fehler kurz nacheinander aufgetreten sind, ist das ein Hinweis. Stelle den Fehler nach, bevor du das Update als Ursache einstufst.

1. Lies die Dokumentation und Versionshinweise des Anbieters zum genauen Block. Notiere die verdächtige Änderung und wähle eine repräsentative Seite aus. Bestätige zuerst, dass der Fehler auch auf der Kopie auftritt, bevor du die Komponente veränderst.
2. Ändere in der Testumgebung zusammen mit der zuständigen Person jeweils nur eine Sache. Sichere die Ausgangsversion und ihre Konfiguration und halte fest, wie du beides wiederherstellen kannst. Öffne dann denselben Inhalt erneut. Lass die Plugins auf der produktiven Website während des Versuchs aktiv.
3. Vergleiche nach dem Versuch Inhalt und Funktionen und stelle die vorherige Konfiguration wieder her, bevor du eine andere Vermutung prüfst. Wenn der Anbieter das Speicherformat geändert hat, sende ihm das kleine Beispiel. Ob alte Blöcke weiterhin funktionieren, hängt von der dokumentierten Migration des Anbieters ab.
4. Brich ab, wenn sich der Fehler auf der Kopie nicht nachstellen lässt oder du den Ausgangszustand nicht wiederherstellen kannst. Lass die Dateien des Anbieters unverändert und prüfe Sicherheit und Kompatibilität, bevor du länger bei einer alten Version bleibst. Wenn die Ursache feststeht, wähle eine Korrektur und prüfe sie, bevor du sie breiter einsetzt.

Bei Bedarf auf gepflegte Blöcke umsteigen

Wird die Komponente nicht mehr gepflegt oder empfiehlt ihr Anbieter eine Migration, halte zuerst fest, wozu jeder Block dient. Text und Bild lassen sich oft mit vorhandenen Blöcken neu aufbauen. Ein Formular, eine Suche oder eine berechnete Anzeige braucht einen Ersatz mit derselben Funktion und einer passenden Darstellung.

Einige Blöcke erzeugen ihre Ausgabe auf dem Server. Der gespeicherte Inhalt enthält möglicherweise nur einen Teil des endgültigen Ergebnisses. Wenn du allein das HTML sicherst, können Informationen oder Funktionen fehlen. Lass den Ersatz für den jeweiligen Blocktyp prüfen, bevor du seine bisherige Komponente entfernst.

Füge auf der Kopie den Ersatz neben dem alten Block ein, übernimm die benötigten Daten und prüfe die Funktionen. Entferne den alten Block erst nach Vergleich und Sicherung. Wenn mehrere Seiten betroffen sind, beginne mit einer repräsentativen Instanz und führe eine Liste der Inhalte, die du noch bearbeiten musst. Entscheidend ist, ob die Inhalte und Funktionen nach der Migration weiterhin nutzbar sind.

Die Reparatur prüfen, bevor du die öffentliche Seite änderst

Öffne den Entwurf nach dem Speichern erneut. Prüfe, ob sich der Block weiterhin bearbeiten lässt und die Meldung ausbleibt. Öffne dann die Vorschau bei breiter und schmaler Darstellung. Prüfe Überschriften, Alternativtexte, die Reihenfolge der Elemente, Links und Inhalte, die sich hinter einem Akkordeon oder einem Tab verbergen.

Lege für interaktive Elemente einen Versuch ohne echte Auswirkungen fest. Ein Formular kann seine Felder anzeigen, obwohl es keine Antworten verarbeitet. Lass für wichtige Funktionen eine geeignete Testumgebung vorbereiten und verwende bei Testsendungen keine echten Empfänger.

Wenn die Reparatur freigegeben ist, übertrage mit den erforderlichen Berechtigungen nur die nötige Korrektur in das Original. Prüfe vor dem Speichern einer bereits veröffentlichten Seite, welche Elemente sich geändert haben. Stimme dich mit anderen Autoren ab, damit ihr die Seite nicht gleichzeitig ändert. Kontrolliere anschließend die öffentliche Seite und öffne den Editor erneut. Bewahre die Kopien auf, bis beide Prüfungen abgeschlossen sind.

Erkennen, wann du abbrechen und gezielt Hilfe holen solltest

Brich die Umwandlung ab, wenn Inhalte verschwinden, eine wichtige Funktion verloren geht oder mehrere Blöcke wiederholt Fehler zeigen. Wende dich bei einer konkreten Inkompatibilität an den Entwickler des Blocks. Frage deinen Hosting-Anbieter nach Sicherungen, einer Testumgebung oder Serverfehlern. Bei WordPress.com kann der Support auf Prüfungen hinweisen, die für den Dienst relevant sind.

Gib die genaue Meldung, die beteiligten Versionen, den Blocknamen, die Schritte zum Nachstellen und das Ergebnis eines dokumentierten Versuchs weiter. Entferne aus dem Beispiel personenbezogene Daten, vertrauliche Geschäftsinformationen und Zugangsdaten. Teile in einem öffentlichen Forum nur das Material, das für die Diagnose erforderlich ist.

Sichere die Website vor Änderungen an ihren Komponenten und prüfe danach einige repräsentative Seiten, damit der Fehler seltener erneut auftritt. Vermeide es, die HTML-Struktur von Blöcken manuell zu ändern, die du weiter im visuellen Editor bearbeiten möchtest. Die Reparatur ist abgeschlossen, wenn die benötigten Inhalte und ihre Funktionen erhalten sind und der Editor sie wieder korrekt speichern kann.