Ratgeber · Updates

WordPress-Wartungsmodus: aktivieren, deaktivieren und wenn er hängt

Christian Galster

Von Christian Galster · aktualisiert am

Im Wartungsmodus zeigt WordPress Besuchern statt der Website eine kurze Meldung. Bei jedem WordPress-Update schaltet WordPress ihn von selbst ein und danach wieder aus. Du kannst ihn auch bewusst einschalten, etwa während eines größeren Umbaus.

Was der WordPress-Wartungsmodus ist

Der eingebaute Wartungsmodus hängt an einer einzigen Datei: .maintenance im Hauptverzeichnis von WordPress, also in dem Ordner, in dem auch wp-admin liegt (FAQ von WordPress.org). Darin steht nur der Zeitpunkt, zu dem das Update begonnen hat.

Liegt die Datei dort, antwortet WordPress auf jeden Aufruf mit dieser Meldung:

Diese Website ist aufgrund planmäßiger Wartungsarbeiten vorübergehend nicht verfügbar. Bitte versuche es in wenigen Minuten erneut.

So lautet sie auf einer deutschen Installation, auf Englisch heißt sie „Briefly unavailable for scheduled maintenance. Check back in a minute.“ Dazu sendet WordPress den Statuscode 503 und den Hinweis Retry-After: 600. Für Suchmaschinen bedeutet das: vorübergehend nicht erreichbar, in zehn Minuten wieder versuchen.

WordPress sucht die Datei sehr früh, noch bevor es Plugins und Theme lädt und weiß, wer angemeldet ist. Deshalb sehen auch Administratoren nur die Meldung. Das Backend bleibt zu. Eine Ausnahme für angemeldete Benutzer gibt es nicht.

Wann WordPress den Wartungsmodus selbst einschaltet

WordPress schaltet den Wartungsmodus nur ein, wenn ein Update laufende Teile der Website austauscht. Ein Update des WordPress-Kerns löst ihn immer aus. Bei Plugin-Updates springt er nur an, wenn mindestens eines der aktualisierten Plugins aktiv ist, bei Themes nur, wenn das aktive Theme oder sein Eltern-Theme betroffen ist. Updates inaktiver Plugins und neue Übersetzungen laufen ohne Wartungsmodus.

Aktualisierst du mehrere Plugins auf einmal, bleibt der Wartungsmodus an, bis das letzte fertig ist. Je mehr Updates in einem Durchgang laufen, desto länger ist die Website also gesperrt. Seit Version 6.6 schaltet WordPress den Wartungsmodus auch für automatische Updates ein, damit es danach prüfen kann, ob das Update einen schweren Fehler ausgelöst hat (Merge-Vorschlag zur Rollback-Funktion). Übersetzungen sind davon ausgenommen.

Im Backend siehst du während des Updates die Zeilen „Wartungsmodus wird aktiviert …“ und „Wartungsmodus wird deaktiviert …“. Erscheint die zweite Zeile, ist die Website wieder erreichbar.

Wenn der WordPress-Wartungsmodus hängt

Meist hilft schon Warten. Ist die Datei .maintenance zehn Minuten alt, ignoriert WordPress sie und zeigt die Website wieder an (Code-Referenz). Die Datei bleibt dabei liegen.

Willst du nicht warten, löschst du die Datei selbst:

  1. Verbinde dich per SFTP mit dem Server oder öffne den Dateimanager deines Hosters.
  2. Öffne das Hauptverzeichnis von WordPress, den Ordner mit wp-admin, wp-content und wp-includes.
  3. Lösche die Datei .maintenance. Weil ihr Name mit einem Punkt beginnt, blenden viele Programme sie aus. In FileZilla holst du sie über das Menü „Server“ mit „Anzeige versteckter Dateien erzwingen“ hervor.
  4. Ruf die Website auf und melde dich im Backend an.

Solange die Datei liegt, zeigt das Backend außerdem den Hinweis „Eine automatische WordPress-Aktualisierung konnte nicht abgeschlossen werden. Versuche bitte, die Aktualisierung jetzt erneut zu starten.“ Er bleibt auch nach den zehn Minuten stehen und verschwindet erst, wenn du die Datei gelöscht hast. Die offizielle FAQ rät, das Update danach erneut auszuführen, falls es fehlgeschlagen ist.

Warum der WordPress-Wartungsmodus hängen bleibt

Die Datei bleibt liegen, wenn das Update abbricht, bevor WordPress sie wieder löschen kann. Die Dokumentation nennt als Gründe für fehlgeschlagene Updates eine gestörte Verbindung zu den WordPress-Servern, eine abgebrochene Internetverbindung und falsche Dateirechte (Handbuch). Dazu kommen Zeitlimits. Läuft ein Update länger, als der Server einem PHP-Skript erlaubt, bricht es mittendrin ab. Im deutschen Support-Forum berichten Nutzer auch von Updates, die an zu wenig Arbeitsspeicher scheiterten.

Ein Update, das du im Backend gestartet hast, kann auch abbrechen, wenn du den Browser-Tab vorher schließt. PHP beendet ein Skript standardmäßig, sobald die Verbindung zum Browser abreißt (PHP-Handbuch), und die Update-Routinen von WordPress schalten das nicht ab. Ob es wirklich abbricht, hängt vom Server ab. Lass den Tab trotzdem offen.

Bleibt die Meldung auch nach zehn Minuten und ohne .maintenance-Datei, steckt etwas anderes dahinter. Manche Themes und Plugins haben einen eigenen Wartungsmodus, der mit dieser Datei nichts zu tun hat. Im Forum sperrte ein Theme-Update auf diese Weise den Administrator aus. Auch ein Cache vor WordPress, etwa beim Hoster oder in einem CDN, kann noch eine alte Fassung ausliefern.

Was du nach dem hängenden Wartungsmodus prüfst

Nach dem Löschen siehst du zuerst unter „Dashboard > Aktualisierungen“ nach. Steht das Update dort noch aus, ist es nicht vollständig durchgelaufen. Liegen im Ordner wp-content/upgrade noch Unterordner, deutet das auf ein abgebrochenes Update hin. WordPress räumt den Ordner beim nächsten Update selbst auf.

Bei einem von Hand gestarteten Plugin- oder Theme-Update, das schon beim Installieren scheitert, holt WordPress seit Version 6.3 die vorherige Version aus dem Ordner wp-content/upgrade-temp-backup zurück. Wirkt ein Plugin nach dem Abbruch beschädigt, lösche seinen Ordner per SFTP und lade eine frische Kopie hoch. Lösche es nicht im Backend, sonst läuft die Deinstallationsroutine des Plugins und kann seine Einstellungen entfernen. Wie du auf eine ältere Version zurückgehst, steht im Artikel WordPress-Update rückgängig machen.

Startest du ein Update des Kerns sofort erneut, meldet WordPress womöglich „Momentan wird eine andere Aktualisierung durchgeführt.“ Das Kern-Update setzt eine Sperre für 15 Minuten. Danach lässt es sich neu starten.

WordPress-Wartungsmodus aktivieren

Für eine geplante Wartung, etwa einen Umbau oder einen Umzug, schaltest du den Wartungsmodus bewusst ein. Am einfachsten geht das mit einem Plugin. Ohne Plugin gibt es drei Wege, alle mit Haken.

Wartungsmodus mit Plugin aktivieren

Ein gutes Wartungs-Plugin sendet den Statuscode 503, lässt angemeldete Benutzer auf die Website und nimmt einzelne Seiten aus. Das sind die verbreitetsten im Plugin-Verzeichnis von WordPress.org (Stand Oktober 2026):

Plugin Aktive Installationen Statuscode im Wartungsmodus
Maintenance (WebFactory) über 1 Million 503 nur mit eingeschalteter Option
SeedProd Coming Soon Page, Maintenance Mode über 600.000 503
LightStart (früher WP Maintenance Mode) über 400.000 503 mit Retry-After
CMP Coming Soon & Maintenance über 200.000 wählbar: 200 oder 503
Slim Maintenance Mode über 10.000 503

Wer mit Elementor baut, braucht kein zusätzliches Plugin. Elementor bringt einen eigenen Wartungsmodus mit, der ebenfalls 503 sendet (Elementor-Hilfe).

Prüfe nach dem Einschalten, ob Impressum und Datenschutzerklärung erreichbar bleiben. Nach § 5 des Digitale-Dienste-Gesetzes müssen die Angaben im Impressum „ständig verfügbar“ sein (§ 5 DDG). Bei einer Wartung von ein paar Minuten spielt das kaum eine Rolle, bei einer Sperre über Tage schon. Die meisten der genannten Plugins lassen einzelne Seiten vom Wartungsmodus aus.

Wartungsmodus ohne Plugin aktivieren

Datei .maintenance von Hand anlegen. Legst du im Hauptverzeichnis eine Datei .maintenance mit diesem Inhalt an, schaltet WordPress den Wartungsmodus ein:

<?php $upgrading = time(); ?>

Weil time() bei jedem Aufruf die aktuelle Zeit liefert, endet der Modus nicht nach zehn Minuten. Er hält, bis du die Datei wieder löschst, und sperrt so lange alle aus, auch dich im Backend. Liegt auf dem Server keine eigene robots.txt, die Datei mit den Regeln für Suchmaschinen, liefert WordPress sie selbst aus, und dann antwortet auch sie mit 503. Google ruft keine Seite der Website mehr ab, solange die robots.txt so antwortet (Google zu Ausfallzeiten). Für mehr als eine kurze Wartung taugt dieser Weg deshalb nicht.

WP-CLI. Mit Zugang zur Kommandozeile schaltest du den Modus mit wp maintenance-mode activate ein und mit wp maintenance-mode deactivate wieder aus. wp maintenance-mode status zeigt, ob er aktiv ist (WP-CLI-Dokumentation). Wie ein Update legt er die Datei .maintenance mit einem festen Zeitpunkt an, deshalb endet der Modus auch hier nach zehn Minuten von selbst. WP-CLI selbst läuft auch bei aktivem Wartungsmodus weiter, du kannst also Plugins deaktivieren oder Updates wiederholen, während die Website gesperrt ist.

Eigener Code. In Ratgebern kursieren Schnipsel für die functions.php, die per wp_die() eine Wartungsseite zeigen und Administratoren ausnehmen. Ohne ausdrückliche Angabe sendet wp_die() den Statuscode 500 statt 503 (Code-Referenz). Viele Schnipsel prüfen das Recht edit_themes, das WordPress niemandem gibt, sobald in der wp-config.php der Datei-Editor mit DISALLOW_FILE_EDIT abgeschaltet ist. Dann sperrt der Schnipsel auch dich aus.

Eigene Wartungsseite mit maintenance.php

Statt der Standardmeldung zeigt WordPress den Inhalt der Datei wp-content/maintenance.php, wenn es sie gibt (Code-Referenz). Sie ändert nur die Anzeige, einschalten musst du den Wartungsmodus weiterhin über .maintenance. Bis einschließlich WordPress 7.1 sendet WordPress mit dieser Datei keinen Statuscode 503, die Seite geht dann mit 200 raus. Die Datei muss den Status deshalb selbst setzen. WordPress hat seine eigenen Funktionen dafür zu diesem Zeitpunkt noch nicht geladen, es geht also nur mit reinem PHP über http_response_code( 503 ). Für WordPress 7.2 ist eine Korrektur eingeplant (Änderung im Quelltext).

Wartungsmodus und Google

Ein kurzer Wartungsmodus mit Statuscode 503 schadet dem Ranking nicht. Google wertet 503 als vorübergehende Störung und kommt später wieder. Kritisch wird es erst, wenn die Website über Tage so antwortet.

Laut Google sollten die Codes 500, 503 und 429 nur für kurze Zeit gelten, also Stunden oder ein bis zwei Tage. Findet der Googlebot sie mehrere Tage lang unter derselben Adresse, kann die Seite aus dem Index fallen (Google Search Central). Solange eine Seite 503 liefert, kann Google außerdem Titel, Beschreibung und strukturierte Daten nicht aktualisieren.

Eine Wartungsseite mit Status 200 ist für Google eine normale Seite mit dem Inhalt „Wartung“. Das passiert bei Plugins, deren 503-Option nicht eingeschaltet ist, und bei einer maintenance.php ohne eigenen Statuscode. Prüfen lässt sich der Status mit dem Befehl curl -I und der Adresse der Website: In der ersten Zeile der Antwort steht der Code.

Wartungsmodus oder Coming-soon-Seite

Der Wartungsmodus ist für kurze Unterbrechungen einer laufenden Website gedacht und sendet 503. Eine Coming-soon-Seite steht vor einer Website, die noch nicht gestartet ist, und antwortet mit 200, bleibt also für Suchmaschinen sichtbar. Elementor trennt die beiden Modi genau so (Elementor-Hilfe).

Für eine Pause, die länger als ein bis zwei Tage dauert, empfiehlt Google ebenfalls eine indexierbare Seite mit Status 200 statt eines Wartungsmodus. Auf ihr kann stehen, wann es weitergeht und wie man dich erreicht.

Häufige Fragen zum WordPress-Wartungsmodus

Wie lange dauert der Wartungsmodus bei einem WordPress-Update?

So lange, wie WordPress Dateien austauscht, bei einem einzelnen Plugin meist nur kurz. Bei einem Sammel-Update mehrerer Plugins bleibt er an, bis das letzte fertig ist. Spätestens nach zehn Minuten ignoriert WordPress die Datei .maintenance, auch wenn das Update abgebrochen ist.

Sehen Administratoren die Website im Wartungsmodus?

Beim eingebauten Wartungsmodus nicht. WordPress prüft ihn, bevor es die Anmeldung auswertet, deshalb sehen auch Administratoren nur die Meldung und kommen nicht ins Backend. Wartungs-Plugins lassen angemeldete Benutzer dagegen in der Regel durch.

Schadet der Wartungsmodus dem Google-Ranking?

Nicht, wenn er kurz bleibt und den Statuscode 503 sendet. Liefert eine Seite mehrere Tage lang 503, kann Google sie aus dem Index nehmen. Eine Wartungsseite mit Status 200 wertet Google als normale Seite.

Wo liegt die Datei .maintenance für den Wartungsmodus?

Im Hauptverzeichnis von WordPress, in dem Ordner mit wp-admin, wp-content und wp-includes. Liegt WordPress in einem Unterordner, steht sie dort und nicht im obersten Verzeichnis des Webspace. Weil ihr Name mit einem Punkt beginnt, zeigen viele FTP-Programme sie erst an, wenn du versteckte Dateien einblendest.

Kann ich Impressum und Datenschutzerklärung vom Wartungsmodus ausnehmen?

Mit einem Wartungs-Plugin ja, die meisten bieten eine Liste von Seiten, die erreichbar bleiben. Der eingebaute Wartungsmodus von WordPress kennt keine Ausnahmen. Bei längerer Wartung lohnt sich ein Plugin, weil das Impressum nach § 5 des Digitale-Dienste-Gesetzes ständig verfügbar sein muss.

Quellen

  1. wp_is_maintenance_mode() WordPress Code Reference
  2. FAQ Troubleshooting WordPress.org
  3. Common WordPress Errors WordPress Advanced Administration Handbook
  4. wp maintenance-mode WP-CLI
  5. Crawling-Frequenz von Googlebot reduzieren Google Search Central
  6. Onlineunternehmen pausieren Google Search Central
  7. § 5 Digitale-Dienste-Gesetz Bundesministerium der Justiz