Is your WordPress site stuck in maintenance mode, and you aren’t able to find any way out? Then, in this tutorial, we’ll look into the issue and help you unstuck your website from maintenance mode. There will be no heavy lifting or anything hardcode-related that might put you in confusion. You will be able to fix this issue easily in no time.
So, without any further ado, let’s get started.
Table of Contents
Why is WordPress Stuck in Maintenance Mode?
If you’re asking yourself over and over, “Why is my WordPress site down,” after seeing a maintenance mode message that says, “Briefly unavailable for scheduled maintenance. Check back in a minute,” you should calm yourself first. It’s a simple issue that can be solved without giving yourself a hard time.
However, before you solve it, you must know why your website is down and why you are seeing that message repeatedly. The reason is that it’s not a bug or some kind of spam. Instead, it’s a mode that WordPress activates when it goes through an update, either manually or automatically.
Whenever WordPress gets an update, it creates a file called .maintenance in the database. This file then displays the message to users, while in the background, the update does its work. As soon as the update is done, WordPress deletes the file. Thus, after disabling the WordPress maintenance mode, users will access the site as they were before.
Now, this process doesn’t take time and comes and goes without creating any issues. Despite this, there are times when things go unexpectedly, and you’d probably see the maintenance mode message as well as be unable to access the site.
And why does this all happen? Because, after the update, the .maintenance file didn’t get deleted. And, the reason for the file not being deleted could be any of the following,
- While running an update (manual or automatic), you accidentally/unknowingly close the browser.
- The update timed out on its own.
- You were running a bulk update for both plugins and themes.
- A glitch occurred in the update process due to an incompatibility issue.
- You’ve used a plugin to enable the maintenance mode.
Whether you know the cause or not, the best thing is that you can take WordPress out of maintenance mode very easily. All you have to do is follow the steps one by one carefully. And below, we’re going to do the same.
How to Fix WordPress Stuck in Maintenance Mode?
Spare me if I’m getting too philosophical, but we can always overcome our problems if we look at them in the right direction. The same is true with a WordPress site being stuck in maintenance mode. Based on your hosting access level and WordPress experience, follow the below ideas to unstuck WordPress from maintenance mode.
- Reach Your Hosting Providers’ Customer Support
- Delete the “.maintenance” File
- Get Access to the cPanel & Delete the “.maintenance” File
- Use an FTP Client to Fix WordPress Maintenance Mode Stuck Issue
- Try an SSH Connection
- If the Maintenance Mode Problem Is Due to Plugins or Themes (When You Don’t Find Any .maintenance File)
1. Reach Your Hosting Providers’ Customer Support
If you’re not into technical stuff. Or don’t have access to the website’s database, then you can probably reach your hosting provider’s customer support desk. Or in case you’ve designed the website through a web development agency, you can contact them as well.
Let them know you’re facing the WordPress stuck in maintenance mode problem and want it to be resolved as soon as possible. If you’ve got hosting providers like Hostinger or WordPress web development agencies like Elicus, your issue will be resolved without letting you wait.
This is the simple and best approach if you don’t know how to handle the database or have access. Even though you’ve got access, you can try this to save time and effectively resolve the WordPress maintenance mode issue.
2. Delete the “.maintenance” File
To disable WordPress maintenance mode, we’ve to delete the .maintenance file. And to do that, we need to get access to our website’s database. You can use one of the following methods to access your WordPress site’s database according to your suitability.
a. Get Access to the cPanel & Delete the “.maintenance” File
If your hosting provider offers you a cPanel to access the website’s database files, simply log in to it. Then, go to the File Manager app and open it. Here, you need to open the public_html folder.
Look for the .maintenance file, and once found, either right-click to access the Delete option. Or select the file, and then use the Delete icon in the taskbar to delete it.
Once deleted the file, check if your WordPress site is out of maintenance mode, which it should be. Otherwise, move to step 3.
b. Use an FTP Client to Fix WordPress Maintenance Mode Stuck Issue
For instance, you don’t have access to the website’s cPanel. Or prefer to use an FTP, then follow the steps below to delete the .maintenance file.
- First, download and install an FTP client like FileZilla or Cyberduck.
- Then, use your FTP credentials to access the file manager. If you don’t know how to do it, you can follow this guide on using an FTP client.
- Once you’ve gained access, open the public_html folder.
- Then, look for the .maintenance file. If you don’t see the .maintenance file in the WordPress root folder, make sure you check the show hidden files option in your FTP client application.
- To do that, go to the Server → click Force showing hidden files.
- Once found the file, simply delete it.
- Doing so will get your WordPress out of maintenance mode. If you’re still not able to see the website’s content, make sure you reload the site and clear the browser’s cache.
- Otherwise, move to the 3rd step.
c. Try an SSH Connection
If you prefer to access the website’s database by establishing an SSH connection, the following steps will help you delete the .maintenance file.
- First, download and install an SSH connection establisher—for example, PuTTY or Xshell 7.
- Then, set up an SSH connection. If you don’t know how to do that, you can follow this guide on establishing an SSH connection.
- Once the connection is established, open the WordPress root folder.
- Then, using the ‘rm .maintenance‘ command, delete the .maintenance file.
- This will disable the maintenance mode of WordPress.
3. If the Maintenance Mode Problem Is Due to Plugins or Themes (When You Don’t Find Any .maintenance File)
The above methods will work if there is a maintenance mode file. However, what will you do if you don’t find any maintenance mode file even after enabling the force hidden files showcase option? Well, in that case, you’ve to work on your plugins or themes file. It’s possible your WordPress site is stuck in maintenance mode due to some conflict caused by incompatible plugins or themes’ files.
To troubleshoot this issue, first, you could try with the plugin files. You need to open the wp-content folder using the FTP client or your file manager.
Now, change the plugins’ folder name to _plugins and check whether you’re able to access the site or not. If you can, then rename the folder back to its original name, that is, plugins.
After this, disable and re-enable plugins until your site breaks again to find out which plugin is causing the issue. Once you’ve found out the troubling plugin, run a manual update for it. If you don’t find any faulty plugins, try the same approach for the themes folder by changing the name to _themes. Then, disabling and re-enabling them to narrow down the issue.
If this all doesn’t work, then what might be causing the maintenance error would be the wp-activate.php file requiring a manual update. You need to open the public_html folder again and look for this file.
Download it on your system, open it, and look for this code: define (‘WP_INSTALLING’, true). You need to change the true value to false, just like this: define (‘WP_INSTALLING’, false). Make sure you change the value by typing instead of copying and pasting.
Once you’ve made the changes, save the file and upload it back to the public_html folder. Doing so would probably restore your WordPress site and take it out of maintenance mode.
That’s it; you’ve successfully repaired your WordPress site stuck in maintenance mode. Now, let’s check out the ideas that can prevent your website from going into this situation again.
How to Prevent Maintenance Mode Issues from Happening Again in WordPress
Even though you’ve repaired your WordPress site by deleting the .maintenance file, there is a solid chance that it can occur again if you repeat the mistake. Therefore, to keep your site from getting stuck in maintenance mode again, follow the tips below.
Don’t Install Non-Compatible Plugins or Themes
If a plugin or theme isn’t compatible with your current WordPress version, you’re putting your website in two major dangers by installing it.
First, the plugin or theme is vulnerable to spam or hacker attacks.
Second, it will include files that wouldn’t agree with the processes of WordPress. As a result, you’ll probably see WordPress stuck in maintenance mode after updating the plugin or theme.
Therefore, when you install plugins or themes, always go with the ones that are compatible with the current version of WordPress. Or tested up to the previous recent version. In this way, you’ll keep your WordPress website safe from being stuck in maintenance mode.
Check How Long It Has Been Since the Plugin or Theme Was Updated
Even though the plugin or theme is compatible, there are still chances that it could put WordPress in maintenance mode if it’s not updated recently. Why? Because WordPress gets frequent updates, you can expect 1 minor or major update within two months. And if the plugin hasn’t been updated for 3 months, then there’s no doubt it will include some files that might cause conflict and keep your WordPress stuck in maintenance mode.
Therefore, to prevent your website from getting stuck in maintenance mode, always install plugins or themes that are updated within 1 month.
Don’t install plugins that have not been updated for two or more months.
You can keep the already installed plugins because they’ve been there before the current version of WordPress got installed on your website. So, there will be no conflict. Nevertheless, if a new major version of WordPress is available, then don’t rush to install it. Rather, wait for another subsequent version and first install updates of the plugins and themes.
This will keep your website from breaking when you install the newer version of WordPress because, at that time, updated plugins will have files compatible with WordPress. So, there will be fewer chances of WordPress getting stuck in maintenance mode.
Don’t Update Multiple Plugins or Themes at Once
If you update more than one plugin or theme at a time, it will increase the number of requests. Plus, the server will take more time to process them. In this, there are chances that while responding to a particular request, the server timed out for another request. Thus, it will put WordPress in maintenance mode.
Therefore, whenever you update your plugins or themes, make sure you do it manually, not the bulk option. And while doing that, you let the previous plugin update finish before you start updating another.
When Facing the Issue and Can’t Resolve on Your Own, Hire the Best WordPress Maintenance Services Providers
It’s likely that after seeing WordPress stuck in maintenance mode, you try to resolve it on your own. But if you’re not familiar with the technical part of WordPress, it’s best that you hire WordPress maintenance service providers.
There are multiple best WordPress maintenance services providers in the market whom you can rely on for this kind of situation.
For instance, you can get WP maintenance service from Divi Extended. With over a decade of experience designing WordPress websites and developing best-selling WordPress products, we know how to resolve that issue quickly and effectively.
So, if you are facing this issue right now and are unable to resolve it, reach out to us and get quality WordPress maintenance services.
Wrapping Up
Above, we looked at the issue that causes WordPress to be stuck in maintenance mode.
Plus, we’ve also viewed troubleshooting methods and how you can make your WordPress site work again like before. I hope, using the methods above, you’ll be able to take your WordPress site out of maintenance mode easily.
Still, if you find difficulty with that, you can reach our support team, where we’ll be happy to provide assistance. Not only maintenance mode, but anything you’d require related to WordPress and web development.
0 Comments