WordPress maintenance mode is a WordPress core feature that’s enabled when you update the version of WordPress or while updating plugins and themes. The CMS displays a message across your website that lets visitors know you’re working on something. This way, you can perform updates without forcing them to use a semi-broken site.

his post explains how to manually get out of the unwanted WordPress maintenance mode in case your site gets stuck in it. You might be wondering what it is and why it’s happening.

We will cover:

What Causes WordPress Maintenance Mode Issues?
Possibility 1: The .maintenance File Still Exists in the Site's Root Folder
How to Delete the .maintenance File in cPanel
How to Delete the .maintenance File via FileZilla
How to Resolve the .maintenance Issue via SSH
Possibility 2: There is a Theme or Plugin that has not Updated Correctly
Theme and Plugin Solutions to Fix WordPress Stuck in Maintenance Mode
Prevent Future WordPress Maintenance Mode Issues
Ensure Plugins/Themes are Compatible
Avoid Updating all Plugins at Once.


What Causes WordPress Maintenance Mode Issues?

Anytime you update your plugins and themes, WordPress maintenance mode would kick in, displaying a message that says your site is temporarily unavailable. The updates take only a few seconds and are too brief to be noticed. However, sometimes, the process would get interrupted. This hiccup could come from errors in server connection, or when a browser or a page was closed while the update was going on. Whatever the case is, the solutions for this issue are two.
Possibility 1: The .maintenance File Still Exists in the Site's Root Folder

Typically, this would be the main reason in case the maintenance mode is stuck. What you need to do is access your server via FTP software like FileZilla, or by using the File Manager in your cPanel (cPanel → File Manager).
How to Delete the .maintenance File in cPanel

cPanel is not the only existing control panel, but it’s probably the most popular one. If you are one of our clients, you already know that we are one of the hosting providers that use cPanel. To delete the .maintenance file in cPanel, follow these steps:

Log into your cPanel and scroll down to find File Manager. By default, many file managers hide all files that have a dot prefix, thus you have to make sure that those hidden files are showing, so you can find the .maintenance file. Go to Settings and check the box Show Hidden Files (dotfiles):
In File Manager, you need to select Web Root (public_html). If working on an addon domain, the folder's name would be the same as the addon domain name.
Open public_html. Doing it would take you directly to the location of your .maintenance file;
Find it, delete it, and then refresh your browser with your WordPress site open to see if the message is still there;
In case the pop-up doesn't appear when you click on File Manager, and if you don't see dot files in your public_html directory, you have to go back to cPanel, scroll down to the bottom, and then click Reset All Interface Settings;
Refresh the page and try again. Clear the cache of your browser if it still doesn’t work.


How to Delete the .maintenance File via FileZilla

An FTP Client is a file manager that you can use on your local device. By default, it comes with more features than the file managers that are available through hosts. we recommends using FileZilla, as does WordPress. To delete the .maintenance file with FileZilla, follow these steps:

After you have the FileZilla installer, open it and go to File → Site Manager;
You will need to know your FTP details. Typically, it would be the username and password that you use to access your website’s file manager, but if you are not sure, ask your host;
Click on New Site. Make sure you select the General tab and configure the following settings:

Host – Enter your domain (e.g., example.com) Port – Leave it blank;
Protocol – FTP (File Transfer Protocol);
Encryption – Only use plain FTP;
Login Type – Normal;
User – FTP username from the host;
Password – FTP password from the host;

Click over to the Transfer Settings tab. Tick the box that says Limit Number of Simultaneous Connections, and enter 8 as the Maximum Number of Connections. This keeps the server from blocking your IP address, especially if you’re on a shared hosting server;
Click Connect. If you see folders named wp-content and wp-admin, you’re in the right place. If not, double click your root directory folder. This typically ispublic_html, but ask your host if you’re not sure;
If you do not see any files with a dot prefix, click Server, and select Force Showing Hidden Files. Find the .maintenance file, delete it, and then click the Refresh the File and Folder Lists button, and refresh your browser to check your site. Clear your cache and check again if you’re having issues.


How to Resolve the .maintenance Issue via SSH

To Rename the .maintenance file via SSH:

Use the following line:

cd public_html

this way you go into the root directory of the primary domain - if it is an addon, simply check this from the Addon Domain tab in the cPanel and replace public_html with the directory shown there. It is usually named after the domain itself - for instance: cd example.com
Next, use the following line:

ls -la

it lists all the files and folders with the current directory - this also lists hidden files (files that have a dot prefix before them) mv .maintenance .maintenance-disable - renames the maintenance file so that the message is no longer shown in the browser.

To disable plugins/themes via SSH:

Enter the following line:

cd wp-content

once inside the public_html, or the root directory of the problematic domain, you go within the wp-content folder, which holds WordPress’s most valuable assets such as plugins, themes, images, videos, etc.
The next line is:

mv plugins plugins-disable

this renames the directory that keeps the plugins, so they are no longer usable by WordPress, thus allowing you to access your website normally.
Next, we input:

mv themes themes-disable

it renames the themes directory so that they would no longer be usable by WordPress (this might also show a blank page, however, it will still allow us to access the administrative area of our website), thus allowing you to access your website normally.