Email VPS
Troubleshooting and repair

WordPress stuck in maintenance mode, how to release the site

The site is stuck in maintenance mode

While updating, WordPress takes the site offline for a moment and shows the text Briefly unavailable for scheduled maintenance. Check back in a minute. Normally that lasts a few seconds. If it does not clear, the update was interrupted and the site stayed locked.

In short

  • The lock is one file called .maintenance in the site root.
  • Deleting the file opens the site immediately.
  • After deleting it, check that the interrupted update actually finished.

1. Wait a minute

If the update is still running, interrupting it does more harm than waiting. Reload the page after a minute. Only if the text is still there, move on to the next step.

2. Delete the .maintenance file

Connect over FTP or SFTP to the site root, the directory that holds wp-config.php and wp-content. You will find a file called .maintenance. It starts with a dot, so many clients hide it and you need to turn on showing hidden files. Delete it and reload the site. It opens right away. Making the connection is covered in our guide to FTP and SFTP.

3. Find out which update was left halfway

The site is open but the work is unfinished. Log in and look at the updates screen to see whether a plugin or a theme is still on the old version. Run the update again, one at a time. If the same update keeps stopping at the same point, that is not chance, it means it does not fit inside the server time or memory limit.

4. Clear the cache

If the maintenance text is still visible after the file is gone, it is coming from a cache rather than from WordPress. Clear the site cache and the browser cache, and try in a private browser window.

5. If the site does not open even after deleting

Then the interrupted update managed to break something else. The usual outcome is a blank page or a critical error, and both have a guide of their own. See the white screen in WordPress and a critical error on the site.

What not to do

Do not start several updates at once on a slow connection and do not close the browser mid update. That is exactly how maintenance mode gets stuck. Take a backup before large updates, see our guide on backing up a site.

If you would rather not do it yourself

We release the lock, finish the interrupted update and check that it did not break anything else. We also find out why it stopped, because otherwise the same thing happens next time.

See how we repair a broken site »