WordPress-Plugin nach fehlerhaftem Update zurücksetzen: Rollback auf die vorherige Version

Ein Plugin-Update ist eingespielt, und plötzlich zeigt die Website „Auf dieser Website ist ein kritischer Fehler aufgetreten.“, das Kontaktformular verschickt nichts mehr oder das Layout ist zerschossen. In dieser Lage zählt vor allem eines: die Website schnell wieder in den letzten funktionierenden Zustand bringen und danach in Ruhe die Ursache klären. Diese Anleitung zeigt drei Wege zurück zur vorherigen Plugin-Version: per Plugin im Backend, per ZIP-Upload und per WP-CLI. Sie erklärt außerdem, was WordPress selbst schon automatisch zurückrollt und wo diese Automatik endet.

Voraussetzungen

• WordPress: Die Anleitung wurde mit WordPress 7.1.2 in deutscher Sprache geprüft.
• PHP: mindestens 7.4, wie von WordPress empfohlen. Das Plugin „WP Rollback“ verlangt laut Plugin-Seite ebenfalls PHP 7.4 und WordPress 6.5.
• Zugriff: ein Konto mit der Rolle Administrator im Backend. Für den Notfallweg zusätzlich FTP, SFTP oder den Dateimanager Ihres Hosters, für den WP-CLI-Weg SSH-Zugang mit installiertem WP-CLI.
• Backup: eine aktuelle Sicherung von Datenbank und Ordner wp-content, die Sie auch zurückspielen können. Ohne Backup führen Sie keinen der folgenden Schritte auf der Live-Website aus.
• Versionsnummer: Sie wissen, welche Version vor dem Update lief. Sie steht etwa in den E-Mails zu automatischen Aktualisierungen.

Schritt 1: Lage einschätzen und Website sichern

Bevor Sie etwas zurückdrehen, klären Sie zwei Fragen: Ist das Backend noch erreichbar, und welches Plugin ist schuld? Kam das Problem direkt nach einem einzelnen Update, ist die Zuordnung eindeutig. Wurden mehrere Plugins gleichzeitig aktualisiert, hilft das Fehlerprotokoll. Die Anleitung zum Debug-Modus und zu den Error-Logs zeigt, wie Sie WP_DEBUG_LOG aktivieren. Im Labor lautete die Meldung eines absichtlich defekten Plugins:

PHP Fatal error:  Uncaught Error: Call to undefined function undefined_function_xyz() in /var/www/html/wp-content/plugins/kaputt/kaputt.php:6

Der Pfad hinter wp-content/plugins/ nennt den Ordner des verantwortlichen Plugins. Sichern Sie anschließend den aktuellen Zustand, auch wenn er fehlerhaft ist. Der Grund: Viele Plugins passen beim Update die Datenbank an, und ein Backup von letzter Woche enthält keine neuen Bestellungen oder Anfragen. Mit SSH erledigt das WP-CLI in einer Zeile:

wp db export ~/vor-rollback-$(date +%F).sql

Ohne SSH nutzen Sie die Sicherungsfunktion Ihres Hosters oder Backup-Plugins.

Verifizieren: WP-CLI meldet Success: Exported to '…/vor-rollback-2026-09-30.sql'., und die Datei ist größer als einige Kilobyte. Sie kennen den Ordnernamen (Slug) des Plugins und die Zielversion.

Schritt 2: Website wieder erreichbar machen, falls nichts mehr geht

Zeigt die Website auch im Backend nur „Auf dieser Website ist ein kritischer Fehler aufgetreten.“, kommen Sie nicht an die Plugin-Verwaltung. Seit WordPress 5.2 schickt WordPress in diesem Fall meist eine E-Mail an die Administrator-Adresse mit einem Link in den Wiederherstellungsmodus, in dem das fehlerhafte Plugin pausiert ist. Kommt sie nicht an, hilft der Dateizugriff.

Verbinden Sie sich per FTP oder Dateimanager und benennen Sie den Ordner des Plugins um, zum Beispiel wp-content/plugins/contact-form-7 in contact-form-7.off. WordPress findet die Plugin-Datei dann nicht mehr und lädt sie nicht. Im Labor lieferte die Startseite sofort wieder HTTP 200 statt 500.

Mit SSH geht es eleganter, denn WP-CLI kann das defekte Plugin beim Start überspringen und dann deaktivieren. Ohne den Parameter --skip-plugins bricht WP-CLI mit demselben Fatal Error ab wie die Website:

wp plugin deactivate contact-form-7 --skip-plugins=contact-form-7

Im Labor lautete die Ausgabe Plugin 'kaputt' deactivated. und Success: Deactivated 1 of 1 plugins.. Benennen Sie einen umbenannten Ordner vor Schritt 3 wieder auf den ursprünglichen Namen zurück, sonst installiert WordPress die alte Version neben dem umbenannten Ordner als zweites Plugin.

Verifizieren: Startseite und /wp-admin/ laden wieder. curl -I https://ihre-domain.de/ liefert HTTP/1.1 200 OK (oder eine Weiterleitung 301), nicht mehr 500.

Schritt 3: Rollback im Backend mit WP Rollback

Für Plugins aus dem offiziellen Verzeichnis auf wordpress.org ist das kostenlose Plugin „WP Rollback“ (im Test Version 3.1.2) der bequemste Weg. Premium-Plugins, die nicht auf wordpress.org liegen, unterstützt nur die kostenpflichtige Pro-Version, dafür nutzen Sie Schritt 4.

1. Öffnen Sie „Plugins“ › „Plugin hinzufügen“, suchen Sie nach „WP Rollback“ und klicken Sie auf „Jetzt installieren“ und danach „Aktivieren“.
2. Wechseln Sie zu „Plugins“ › „Installierte Plugins“. Unter jedem Plugin aus dem Verzeichnis erscheint neben „Deaktivieren“ der Link „Rollback“.
3. Klicken Sie beim betroffenen Plugin auf „Rollback“. Es öffnet sich die Seite „Werkzeuge“ › „WP Rollback“ mit der installierten Version und der Liste aller Versionen.
4. Wählen Sie die Version vor dem Update aus.
5. Klicken Sie auf „Rollback“. Der Dialog „Confirm Rollback“ zeigt installierte Version und Zielversion. Bestätigen Sie mit „Rollback Now“.

Im Labor lief das Zurücksetzen von Contact Form 7 von 6.1.6 auf 6.1.5 in wenigen Sekunden durch. Das Protokoll endet mit „All steps completed successfully.“ Die Einstellungen des Plugins bleiben erhalten, weil nur die Plugin-Dateien getauscht werden, nicht die Datenbank.

Verifizieren: Unter „Installierte Plugins“ steht beim Plugin die Zielversion, und es ist weiterhin aktiv. WordPress bietet die neuere Version wieder als Aktualisierung an. Das ist korrekt und der Grund für Schritt 6.

Schritt 4: Rollback per ZIP-Upload ohne Zusatz-Plugin

Seit WordPress 5.5 können Sie ein installiertes Plugin durch Hochladen einer ZIP-Datei ersetzen. Dieser Weg funktioniert auch für Premium-Plugins, sofern Sie die ältere Version beim Anbieter herunterladen können. Für Plugins aus dem Verzeichnis laden Sie ältere Versionen direkt nach dem Muster https://downloads.wordpress.org/plugin/SLUG.VERSION.zip.

1. Laden Sie die ZIP-Datei der gewünschten Version herunter.
2. Öffnen Sie „Plugins“ › „Plugin hinzufügen“ und klicken Sie oben auf „Plugin hochladen“.
3. Wählen Sie die ZIP-Datei aus und klicken Sie auf „Jetzt installieren“.
4. WordPress erkennt, dass das Plugin schon installiert ist, meldet „Dieses Plugin ist bereits installiert.“ und stellt die Angaben „Aktuell“ und „Hochgeladen“ gegenüber. Prüfen Sie, dass bei „Hochgeladen“ die gewünschte ältere Version steht.
5. Klicken Sie auf „Installiertes durch Hochgeladenes ersetzen“. Mit „Abbrechen und zurück“ brechen Sie ohne Änderung ab.

Laden Sie ZIP-Dateien nur von wordpress.org oder aus Ihrem Kundenkonto beim Hersteller, nie von Drittseiten.

Verifizieren: Die Ergebnisseite endet mit „Das Plugin wurde erfolgreich aktualisiert.“, und unter „Installierte Plugins“ steht die ältere Versionsnummer.

Schritt 5: Rollback per WP-CLI

Mit SSH-Zugang ist WP-CLI der schnellste Weg. Der Parameter --version holt eine bestimmte Version von wordpress.org, --force überschreibt die installierte Version ohne Rückfrage:

wp plugin list --fields=name,status,version,update_version
wp plugin install contact-form-7 --version=6.0.6 --force

Im Labor lautete die Ausgabe (gekürzt):

Installing Contact Form 7 (6.0.6)
Herunterladen des Installationspakets von https://downloads.wordpress.org/plugin/contact-form-7.6.0.6.zip ...
Die alte Version des Plugins wird entfernt ...
Das Plugin wurde erfolgreich aktualisiert.
Success: Installed 1 of 1 plugins.

Alternativ funktioniert wp plugin update contact-form-7 --version=6.0.6, was im Test ebenfalls zurückstufte. Ohne --force bricht wp plugin install dagegen mit Warning: contact-form-7: Plugin already installed. ab, ohne etwas zu ändern. Premium-Plugins installieren Sie auf demselben Weg aus einer lokalen ZIP-Datei, etwa wp plugin install ./plugin-1.2.3.zip --force. Prüfen Sie Plugins aus dem Verzeichnis anschließend gegen die offiziellen Prüfsummen:

wp plugin get contact-form-7 --fields=version,status
wp plugin verify-checksums contact-form-7

Verifizieren: wp plugin get zeigt die Zielversion und status active, verify-checksums endet mit Success: Verified 1 of 1 plugins..

Schritt 6: Erneutes Update verhindern und Ursache klären

Nach dem Rollback ist die Website wieder funktionsfähig, aber nur vorläufig. WordPress bietet die fehlerhafte Version weiter als Aktualisierung an. Ist für das Plugin die automatische Aktualisierung eingeschaltet, spielt WordPress sie beim nächsten Lauf erneut ein. Schalten Sie deshalb unter „Plugins“ › „Installierte Plugins“ in der Spalte „Automatische Aktualisierungen“ beim betroffenen Plugin „Automatische Aktualisierungen deaktivieren“. Per WP-CLI:

wp plugin auto-updates disable contact-form-7
wp plugin auto-updates status contact-form-7

Melden Sie den Fehler im Support-Forum des Plugins auf wordpress.org mit WordPress-Version, PHP-Version und der Fehlermeldung aus dem Log, damit der Entwickler ihn nachstellen kann. Sobald eine korrigierte Version erscheint, testen Sie sie zuerst auf einer Staging-Umgebung, etwa einer Kopie wie in der Anleitung WordPress auf dem Synology NAS als Staging-Umgebung, und schalten danach die automatischen Aktualisierungen wieder ein.

Ein Rollback ist ein Notbehelf, kein Dauerzustand. Ältere Versionen enthalten oft Sicherheitslücken, die in der neueren Version geschlossen wurden. Dieser Kreislauf aus Update, Kontrolle, Rückweg und erneutem Versuch ist laufende Pflege. Wer ihn nicht selbst im Kalender halten möchte, kann ihn abgeben: Die WordPress-Wartung von wordpressupdate.de übernimmt Updates von WordPress, Plugins und Themes mit Kompatibilitätsprüfung sowie wöchentliche Backups auf externen Speicher, aus denen sich ein fehlgeschlagenes Update zurückholen lässt.

Verifizieren: wp plugin auto-updates status contact-form-7 zeigt disabled, und in der Plugin-Liste steht beim Plugin „Automatische Aktualisierungen aktivieren“ als Link.

Was WordPress schon selbst zurückrollt

WordPress enthält seit Version 6.3 einen Schutz für manuelle Updates: Das alte Plugin wird während des Updates nach wp-content/upgrade-temp-backup/plugins/ verschoben. Schlägt die Installation fehl stellt WordPress die alte Version wieder her. Aktualisieren Sie ein aktives Plugin manuell und löst die neue Version einen PHP Fatal Error aus, reaktiviert WordPress es nicht. Seit WordPress 6.6 prüft WordPress auch nach automatischen Plugin-Updates per Loopback-Anfrage an die Startseite, ob ein Fatal Error auftritt, stellt in diesem Fall die vorherige Version wieder her und schickt eine E-Mail an die Administrator-Adresse.

Diese Automatik greift nur bei Abbrüchen und PHP Fatal Errors. Ein Update, das technisch sauber läuft, aber ein Formular, den Warenkorb oder das Layout beschädigt, erkennt WordPress nicht. Der Ordner upgrade-temp-backup wird nach einem erfolgreichen Update geleert. Für diese Fälle brauchen Sie die Schritte 3 bis 5.

Typische Fehler

• Warning: contact-form-7: Plugin already installed. Sie haben wp plugin install --version ohne --force aufgerufen. Hängen Sie --force an oder verwenden Sie wp plugin update SLUG --version=X.Y.Z.
• Error: Can't find the requested plugin's version 9.9.9 in the WordPress.org plugin repository (HTTP code 404). Die Versionsnummer gibt es nicht. Prüfen Sie die Schreibweise in der Versionsliste von WP Rollback oder in der erweiterten Ansicht der Plugin-Seite.
• Warning: …zip: Invalid plugin slug. WP-CLI hat den ZIP-Pfad nicht als Datei erkannt und als Plugin-Namen gedeutet. Legen Sie die ZIP-Datei in das WordPress-Verzeichnis und geben Sie den Pfad relativ an.
• WP-CLI bricht selbst mit „PHP Fatal error“ ab. WP-CLI lädt WordPress samt Plugins. Starten Sie den Befehl mit --skip-plugins=SLUG oder notfalls --skip-plugins.
• Nach dem Rollback fehlen Daten oder das Plugin meldet Datenbankfehler. Die neuere Version hat beim Update die Datenbank umgebaut, die ältere versteht das neue Format nicht. Dann hilft nur das Zurückspielen der Datenbank vom Stand vor dem Update. Deshalb gehört vor jedes Update ein Backup.

Häufige Fragen

Gehen beim Rollback meine Plugin-Einstellungen verloren?

Nein. Alle drei Wege tauschen nur die Dateien im Plugin-Ordner. Einstellungen, Formulare und Inhalte liegen in der Datenbank und bleiben unverändert. Das ist zugleich die Grenze: Hat das Update Tabellen verändert, setzt der Rollback diese Änderung nicht zurück.

Kann ich auch WordPress selbst oder ein Theme zurücksetzen?

Themes aus dem Verzeichnis setzen Sie mit WP Rollback über „Design“ › „Themes“ in den Theme-Details zurück, per WP-CLI mit wp theme install SLUG --version=X.Y.Z --force. Ein Downgrade des WordPress-Kerns ist riskanter, weil Major-Versionen die Datenbank aktualisieren. Spielen Sie dafür besser das vollständige Backup zurück.

Wie lange darf ich auf der alten Version bleiben?

So kurz wie möglich. Enthält das übersprungene Update eine Sicherheitskorrektur, ist die Website angreifbar.

Testumfang

Wir haben am 30.09.2026 in einer Testumgebung mit WordPress 7.1.2 Contact Form 7 per WP-CLI aktualisiert und wieder auf ältere Versionen zurückgesetzt. Ein absichtlich defektes Plugin löste den kritischen Fehler aus, den wir durch Umbenennen oder mit --skip-plugins beheben konnten.

Premium-Plugins und die automatische Rücknahme bei Auto-Updates haben wir nicht geprüft. Testen Sie solche Fälle deshalb zuerst auf einer Kopie Ihrer Website.

Fazit

Ein fehlerhaftes Plugin-Update ist kein Grund zur Panik, wenn ein aktuelles Backup vorliegt und Sie die Zielversion kennen. WP Rollback ist der einfachste Weg für Plugins aus dem Verzeichnis, der ZIP-Upload deckt Premium-Plugins ab, und WP-CLI erledigt beides in einer Zeile. Entscheidend ist der Schritt danach: automatische Aktualisierungen für das Plugin aussetzen, Ursache melden und die korrigierte Version zeitnah nachziehen. Wenn Sie Updates, Kontrolle und Backups lieber in feste Hände geben, übernimmt das die WordPress-Wartung von Marcel Schönfelder.

Weiterführende Anleitungen und Quellen

• WordPress Debug-Modus aktivieren: Error-Logs analysieren und Fehler selbst beheben
• WordPress auf dem Synology NAS installieren: eigene Website oder Staging-Umgebung
• WordPress Cron Job einrichten: WP-Cron durch echten System-Cron ersetzen
• Make WordPress Core: Rollback for failed manual plugin and theme updates (6.3)
• Make WordPress Core: Merge Proposal Rollback Auto-Update (6.6)
• WP-CLI-Handbuch: wp plugin install und wp plugin update
• WP Rollback im Plugin-Verzeichnis von wordpress.org
• WordPress-Dokumentation: Plugins and Themes Auto-Updates