Journal · Troubleshooting
WordPress stuck in maintenance mode after an update: what it means and the safe fix
WordPress stuck on "Briefly unavailable for scheduled maintenance" after an update? What it means, the safe fix step by step and how to prevent it.
Short answer
WordPress gets stuck in maintenance mode when an update is interrupted and the temporary .maintenance file it creates isn’t removed. Your site then shows “Briefly unavailable for scheduled maintenance. Check back in a minute.” Wait a few minutes first. If it’s still there, delete the .maintenance file from your site’s main folder using your host’s file manager or FTP, then finish or redo the update that was interrupted, and check the site works.
You clicked “Update”, went to make a cup of tea and came back to a blank page with one line on it: “Briefly unavailable for scheduled maintenance. Check back in a minute.”
Ten minutes later, it’s still there. Your whole site is showing it, not just the admin area.
This is one of the most common WordPress hiccups, and one of the easiest to fix. Nothing is lost. WordPress has simply left a “do not disturb” sign up after an update that didn’t finish. This guide explains what’s happening, the safe fix step by step and how to stop it happening again. If you see a different error after an update, start with WordPress update broke my site.
Key takeaways
- WordPress maintenance mode is a temporary state that WordPress turns on automatically while it installs updates.
- WordPress creates a file called .maintenance in the site’s main folder during an update and deletes it when the update finishes.
- A WordPress site stays stuck in maintenance mode when an update is interrupted and the .maintenance file is left behind.
- Deleting the .maintenance file takes the site out of maintenance mode without losing content.
- The update that was interrupted should be finished or run again afterwards, because it may be half installed.
- Updating one plugin at a time, after a backup, makes a stuck update less likely and easier to fix.
In this guide
- What does “briefly unavailable for scheduled maintenance” mean?
- Why does WordPress get stuck in maintenance mode?
- How do you fix WordPress stuck in maintenance mode?
- What should you check after the fix?
- How do you stop it happening again?
- What I found, what I did, what changed
- Frequently asked questions
- Sources and references
What does “briefly unavailable for scheduled maintenance” mean?
The message means WordPress is, or thinks it is, in the middle of an update. When WordPress updates itself, a plugin or a theme, it puts up a temporary .maintenance file so visitors don’t see a half-updated site. Normally the file disappears within seconds. If you still see the message after a few minutes, the file was left behind (WordPress Developer Resources).
Is my site broken?
No. Your content, pages and settings are all still there. Visitors just can’t see them while the maintenance message is up.
Is it the same as a “coming soon” or maintenance plugin?
No. Some plugins have their own maintenance or “coming soon” mode, which you switch off in the plugin’s settings. The message here comes from WordPress itself, so it’s fixed by removing the file.
Why does WordPress get stuck in maintenance mode?
WordPress gets stuck when an update doesn’t finish cleanly. The most common causes are closing the browser tab mid-update, a slow or interrupted connection, the server running out of time or memory, and updating many plugins at once. The update stops, the clean-up step never runs and the .maintenance file stays.
Here are the usual causes and how to avoid each one.
| Cause | What happened | How to avoid it |
|---|---|---|
| Tab closed mid-update | The update was cut off | Wait for “Update complete” before leaving the page |
| Bulk updates | Many updates ran in one go and one stalled | Update one at a time |
| Server timeout or memory | The server stopped the update partway | Update at a quiet time; ask your host about limits |
| Connection dropped | The download didn’t finish | Use a steady connection |
Why it affects the whole site
The .maintenance file sits in the site’s main folder, so WordPress shows the message to everyone, everywhere, until it’s removed.
How do you fix WordPress stuck in maintenance mode?
To fix it, remove the .maintenance file from your site’s main folder. You can do this with your host’s file manager or an FTP program. WordPress’s own guidance is to delete that file, which is found in your site root. It takes a couple of minutes and doesn’t touch your content.
Step by step
- Wait five minutes. Some updates are slow. Refresh the page once more before you change anything.
- Open your host’s file manager (or connect with FTP) and go to your site’s main folder: the one with wp-config.php, wp-admin and wp-content in it.
- Show hidden files. Files starting with a dot are often hidden. Most file managers have a “show hidden files” setting.
- Download a copy of .maintenance, then delete it from the server. Having a copy means you can put it back, though you won’t need to.
- Refresh your site. The maintenance message should be gone.
If you can’t see a .maintenance file
Check you’re in the right folder and that hidden files are showing. If there’s no file and the message is still there, a caching plugin or your host’s cache may be showing an old copy. Clear the cache and try again.
What should you check after the fix?
After the fix, check the update that was interrupted, because it may be half installed. Go to Dashboard › Updates in WordPress and see what still needs updating. Run that update again, on its own. Then check the site’s main pages, test your contact form and look at it on a phone.
Your after-fix checklist
- Dashboard › Updates: finish any update still listed.
- Plugins page: check nothing has been switched off.
- Main pages: open the homepage, a service page and the contact page, logged out.
- Contact form: send a test message and check it arrives.
If you see a critical error instead
If removing the file reveals “There has been a critical error on this website”, the interrupted update has left a plugin or theme broken. That’s a different fix. I walk through a real one in how I brought a coach’s site back from a critical error.
How do you stop it happening again?
You stop it happening by updating carefully: take a backup first, update one plugin at a time, wait for each to finish and check the site afterwards. Update at a quiet time of day, and don’t close the tab until WordPress says the update is complete. A regular update routine means each update is small and quick.
A safer update routine
- Back up the database and the plugins folder.
- Update one item at a time, waiting for “Update complete”.
- Check the site after each important update.
- Keep a note of what you updated and when.
For how often to update, see the WordPress update schedule.
What I found, what I did, what changed
I haven’t had a site stuck in maintenance mode on my watch yet, so this guide is built on WordPress’s own guidance and on the update routine I use. Here’s that routine on a real site in October 2026, anonymised.
What I found: a family travel blog’s plugin updates, October 2026 (anonymised)
What I found. The host sent a security email flagging four out-of-date plugins on a family travel blog’s test copy, including the cache plugin and a page-builder blocks plugin. Eleven more updates were waiting, including a major jump for a security plugin.What I did. I backed up the database and the plugins folder first. Then I updated only the four flagged plugins and checked all 40 pages for errors. I held the other eleven, including the major jump, for a planned slot, rather than running them all at once.
What changed. All four updates finished cleanly and all 40 pages loaded with no errors. Updating a few at a time, with a backup first, is exactly what keeps a stuck update rare, and quick to undo if one happens.
Your free Website Check
A plain-English report within 24 to 48 hours (Monday to Friday): an overall grade (A–F), what’s working, what isn’t, and your top 3 fixes in order. No login, no call, nothing changed on your site.
Frequently asked questions
How long does WordPress maintenance mode last?
Normally only a few seconds to a minute while an update installs. If your site still shows the maintenance message after five minutes, the update has probably been interrupted and the .maintenance file left behind. Deleting that file from the site’s main folder ends maintenance mode.
Is it safe to delete the .maintenance file?
Yes. The file is temporary and only exists to show the maintenance message during updates. Deleting it doesn’t remove any content or settings. Download a copy first if you’d like a way back, then finish or redo the interrupted update afterwards.
Where is the .maintenance file in WordPress?
It’s in your site’s main folder, the same folder that holds wp-config.php, wp-admin and wp-content. Because its name starts with a dot, it’s often hidden. Turn on “show hidden files” in your host’s file manager or FTP program to see it.
Why is my site still in maintenance mode after deleting the file?
Usually it’s a cached copy of the page. Clear your caching plugin, your host’s cache and your browser cache, then try again. If the message persists, check you deleted the file from the right site’s folder, and whether a maintenance or “coming soon” plugin is switched on.
Can I fix maintenance mode without FTP?
Yes. Most hosts have a file manager in their control panel that works in your browser, so you don’t need an FTP program. Open the file manager, go to your site’s main folder, show hidden files and delete .maintenance.
Will I lose anything if an update is interrupted?
Your content and settings are normally safe, because they live in the database. What can be affected is the plugin, theme or WordPress files being updated at the time. Run that update again on its own, and keep a recent backup so you can restore if needed.
Sources and references
- Common WordPress errors: maintenance mode following upgrade – WordPress Developer Resources.
- Updating WordPress – WordPress.org documentation.
- FAQ troubleshooting – WordPress Developer Resources.
Keep reading
- WordPress update broke my site: what to do in the first hour
- Why ChatGPT and Google describe your business wrongly, and the places they’re reading
- Domain expired and your email stopped?
About the author
Alleo Gordon, founder of WonderlandSites. Studied Computing at London South Bank; IT technician at a sixth form college in Bethnal Green for 3 years; looking after websites since 2018. Read my story
Written with AI help, ideated, checked, and confirmed by Alleo.
Last reviewed 11 November 2026.
Whenever you’re ready, I’m here.
Tell me a little about where you are and where you’d like to be. I’ll reply personally.