Fixing "Briefly unavailable for scheduled maintenance" in WordPress

You started an update and suddenly the whole site shows nothing but: “Briefly unavailable for scheduled maintenance. Check back in a minute.” Minutes later, nothing has changed. What happened: an update was interrupted and WordPress never cleared the maintenance flag. The fix takes less than a minute.

What’s Behind It

During an update, WordPress creates a file called .maintenance in the root directory and shows the maintenance notice while it exists. Normally it’s deleted automatically once the update finishes. If the process breaks off – a timeout, a closed browser tab, or several updates running at once – the file stays behind and the site hangs in maintenance mode. So it’s not a real defect, just a forgotten flag.

The Fix: Remove .maintenance

1. Connect to the webspace via FTP or your host’s file manager.
2. Go to the root directory of your WordPress install (where wp-config.php, wp-content etc. live).
3. The .maintenance file starts with a dot and is often hidden – enable “show hidden files”.
4. Delete the .maintenance file.
5. Reload the site – it should be reachable again immediately.

Afterwards: Finish the Update

The site is back, but the original update may have been incomplete. Go to the backend under Dashboard → Updates and run the interrupted update again cleanly. Then quickly check that the theme and plugins are properly updated.

If the Site Still Hangs Afterwards

If the .maintenance file is gone and the site still won’t load, maintenance mode wasn’t the actual problem – the interrupted update left a deeper issue behind. The site then usually shows a different error: a critical error, a white screen or a 500 error. Sort those out via the overview of WordPress errors. Here a current backup helps you return cleanly to the state before the update.

Stopping It from Happening Again

Update interruptions often come from tight execution times or from running several updates at once. Two things help:

• Apply updates one at a time rather than in a batch.
• Test larger updates in a staging environment before they go live → Update WordPress safely with staging.

---

The file is gone but the site still hangs? Then there’s more to it. Drop us a line – we’ll bring the site and the update to a clean finish.