By Basharat Ali Khan | Last updated: October 21, 2026
WordPress stuck in maintenance mode is one of the scariest-looking errors, but it is usually a quick fix. You update a plugin, and instead of your site coming back, you see the message: Briefly unavailable for scheduled maintenance. Check back in a minute. Then nothing changes, however long you wait.
The cause is almost always a small leftover file, but not always. This guide covers the standard fix, what to do when that file is missing, and how to check that your update actually finished.
Quick Answer
WordPress stuck in maintenance mode is usually fixed by deleting the hidden .maintenance file in your site’s root folder, using your hosting File Manager or FTP. If the file is not there, a maintenance mode plugin or a cached page is the likely cause. After the site is back, check that the interrupted update completed.
Why Does WordPress Get Stuck in Maintenance Mode?
During any core, theme or plugin update, WordPress creates a temporary .maintenance file in your site’s root folder. This file locks the site, so visitors do not see a half-updated, broken page. When the update finishes, WordPress deletes the file and the site returns to normal.
If something interrupts the update, such as a server timeout, a memory limit, a closed browser tab or a lost connection, the file is never deleted. The lock stays in place, and your site keeps showing the maintenance message. The admin area is locked too, so you usually cannot fix it from the dashboard.
Step 1: Delete the .maintenance File
WordPress stuck in maintenance mode is solved by this step in the majority of cases, and it takes a couple of minutes.
- Log in to your hosting control panel (cPanel, hPanel or your host’s File Manager), or connect with FTP.
- Open your site’s root folder, usually called
public_html. - Turn on “Show Hidden Files.” The file starts with a dot, so it is hidden by default. Look for a settings or gear icon in the File Manager.
- Find the file named exactly
.maintenance. It sits next towp-config.phpand thewp-contentfolder. - Delete it.
- Open your site in an incognito or private window to confirm it is back.
Step 2: Use WP-CLI if You Have SSH Access
If you manage your server with SSH and have WP-CLI installed, you can turn maintenance mode off with one command from your site’s folder:
wp maintenance-mode deactivate
This does the same job as deleting the file. Most site owners will not need it, but it is useful on servers where the File Manager is slow or unavailable.
Step 3: Make Sure No Update Is Still Running
Do not delete the file while an update is genuinely in progress. If only a minute or two has passed, wait a little. If more than a few minutes have passed, the update has almost certainly failed, and the file is stuck rather than working. Deleting it at that point does not harm a finished update, because the file is only a lock marker, not something that stores update data.
Step 4: Check That the Interrupted Update Finished
Once your site is back, a stuck maintenance mode often means an update stopped halfway, so do not skip this step.
- Log in and go to Dashboard > Updates. If the plugin, theme or WordPress still shows as needing an update, run it again, this time on its own.
- If a plugin or theme behaves strangely, deactivate and reinstall it. A half-finished update can leave broken files behind.
- If a core WordPress update was interrupted, use Re-install now on the Updates screen. If WordPress asks you to update the database, accept the prompt (it may send you to
/wp-admin/upgrade.php). - Test your key pages, forms and, for stores, the checkout.
Step 5: What to Do if There Is No .maintenance File
WordPress stuck in maintenance mode with no .maintenance file means a different cause. This scenario is often overlooked, and the standard fix does not apply.
A maintenance or coming soon plugin is active
- Open
/wp-content/plugins/in your File Manager or FTP. - Look for a plugin folder with an obvious name, such as one containing “maintenance,” “coming-soon” or “under-construction.”
- Rename that folder (for example, add
-offto the end) to deactivate it. - Refresh your site.
Elementor’s built-in maintenance mode is on
If you use Elementor, go to Elementor > Tools > Maintenance Mode and set the mode to Disabled. Visitors see the maintenance page while logged-in admins see the normal site, which can make it look like nothing is wrong when you check.
Your host has a maintenance mode switch
Some managed hosts have their own maintenance mode toggle in the hosting dashboard. Check there if the message does not come from WordPress.
A cached maintenance page is being served
If you already removed the lock but the message stays, clear your caching plugin’s cache, purge your CDN cache if you use one, and test in an incognito window to rule out browser caching.
Step 6: Find the Plugin That Keeps Causing It
If your site gets stuck repeatedly, one plugin is probably timing out during its own update.
- Note which plugin was updating right before the site got stuck.
- Update that plugin on its own, not as part of a bulk “update all” action.
- If it keeps happening with the same plugin, check for a newer version or consider an alternative.
- Ask your host about your PHP execution time limit. A very low limit makes updates time out, and raising it to a higher value (for example, 300 seconds) often helps.
Step 7: If This Happens on a Local Site
On a local development site (Local, XAMPP and similar tools), the same fix applies. The only difference is the file path: look for .maintenance in your local site’s root folder, inside the tool’s site directory.
How to Prevent WordPress Stuck in Maintenance Mode
- Update plugins one at a time so one slow update cannot affect the rest.
- Avoid updating during busy hours, since server load can cause timeouts.
- Take a backup before updating. A backup is your safety net whatever happens.
- Do not close the tab while an update is running.
- Check your hosting limits. Low PHP time and memory limits cause many failed updates.
- Use a staging site to test big updates first.
Quick Reference Table of WordPress Stuck in Maintenance Mode
If WordPress stuck in maintenance mode still leaves you unsure where to start, match your symptom here.
| Symptom | Likely cause | Fix |
|---|---|---|
| Message appeared right after an update | Stuck .maintenance file |
Step 1 or 2 |
| You are not sure the update is finished | Update still running or failed | Step 3 |
| Site is back but acts strangely | Update stopped halfway | Step 4 |
No .maintenance file found |
Maintenance plugin, Elementor mode or host setting | Step 5 |
| File deleted but message still shows | Cached page | Step 5 (cache) |
| Happens again and again | One plugin timing out | Step 6 |
| Only on localhost | Different local file path | Step 7 |
Frequently Asked Questions for WordPress Stuck in Maintenance Mode
Is it safe to delete the .maintenance file?
Yes, if more than a few minutes have passed since the update started. A finished update removes the file on its own, so a file that is still there after a reasonable time is stuck, not working.
Will deleting the file lose my update progress?
No. The file is only a lock marker. Deleting it does not affect your content, settings or the plugin and theme files. If an update was interrupted, you may need to run it again (Step 4).
Why does the site get stuck every time I update?
One plugin is probably timing out during its update, or your hosting limits are too low. Update plugins one at a time and ask your host about your PHP time and memory limits.
I cannot find the .maintenance file. Why?
Hidden files are not shown by default. Turn on “Show Hidden Files” in your File Manager. If it is still missing, the message probably comes from a maintenance plugin, Elementor’s maintenance mode, your host or a cached page (Step 5).
Can I turn off maintenance mode from the WordPress dashboard?
If the lock comes from a failed update, the dashboard is locked too, so you need File Manager, FTP or WP-CLI. If a plugin or Elementor caused it, you can turn it off from the dashboard when you are logged in.
Should I worry about losing my site?
This error rarely damages your data. Keep a recent backup before any update, and check your site after the fix.
Need Help Getting Your Site Back?
If your site is stuck right now and you need it fixed quickly, contact me here and mention that it is urgent. For regular updates, backups and safe update testing, see my WordPress website maintenance service.
About the author
Basharat Ali Khan is a WordPress developer in Gilgit, Pakistan with 8+ years of experience building custom plugins, Elementor sites and WooCommerce stores.
LinkedIn | WordPress.org profile
Related: WordPress Website Maintenance Service | WordPress Maintenance Cost | WordPress Images Not Uploading | WordPress Services
