WordPress Stuck in Maintenance Mode

WordPress Stuck in Maintenance Mode

Is your WordPress site stuck in maintenance mode? Don’t worry, it happens. Every CMS has it’s own little weird hiccups that happen and this is one unique to WordPress. In this article, we’ll show you a quick method for how you can manually pull WordPress out of maintenance mode in the event that your site gets stuck in maintenance mode. We’ll cover the following:
  • Why you’re seeing the maintenance mode message
  • How to fix the WordPress stuck in maintenance mode
  • Some tips to prevent problems in the future
WordPress site stuck in maintenance mode? No worries, here’s how to fix it.

What Causes WordPress to Get Stuck in Maintenance Mode?

As part of its automatic update system, WordPress has a built-in maintenance mode that it activates whenever you update your software, themes, or plugins from the WordPress dashboard. You can see a message addressing this in the WordPress update interface whenever you run an update:
wordpress maintenance mode process

WordPress maintenance mode example

Most of the time, the handoff from “maintenance mode” to “working site” takes just a few seconds and you never even know your site was in maintenance mode. But sometimes things do go wrong. Some potential causes are:
  • You accidentally close your browser tab in the middle of an automatic update
  • You’re trying to automatically update a huge number of plugins/themes at once
  • There’s a compatibility problem that causes a glitch
As a result, you persistently see this message when you try to visit your site:
Briefly unavailable for scheduled maintenance. Check back in a minute.
Example of WordPress maintenance mode

Example of WordPress maintenance mode

If you’re seeing that message, there’s an easy fix.  

How to Fix WordPress Stuck In Maintenance Mode

When WordPress puts itself into maintenance mode, it does so by creating a file named “.maintenance” in the root folder of your WordPress site. This is the same folder that contains:
  • wp-admin folder
  • wp-config.php
To fix the WordPress stuck in maintenance mode problem, you’ll need to connect to your server via FTP and delete that file. Once you’ve connected to your site via FTP, find the “.maintenance” file in your root folder and delete it:
Delete .maintenance file from root directory

Delete .maintenance file from the root directory

Once you delete that file, your site should function as normal. It is also recommended that you clear the cache on your WordPress site. Assuming the failure wasn’t a result of a compatibility issue, you should run the upgrade again to ensure your site is running the latest version.  

How To Prevent WordPress From Getting Stuck In Maintenance Mode

While the issue is fairly simple to fix, you can still take some positive steps to help decrease the likelihood of your site getting stuck in maintenance mode again.

1. Ensure Plugin/Themes are Compatible

Make sure plugins/themes are compatible with your version of WordPress before updating. You can check confirmed compatibility right from your WordPress dashboard:
WordPress plugin compatibility

WordPress plugin compatibility

2. Avoid Updating all Plugins at Once

Try to avoid executing too many updates at one time. By updating themes/plugins as updates become available (instead of waiting to do them all at once), you can minimize the number of updates WordPress has to do each time. You can watch the following video as well if you are facing difficulty in reading the whole thing:
If you like our blog post give it a thumbs up and if you did not then comment down your views in the comments section below. Previous Post
Qualified Hafiza Online Corporate Advisory