Introduction
You update a plugin or theme…
Then suddenly your website shows:
“Briefly unavailable for scheduled maintenance. Check back in a minute.”
And it never goes away 😩
Don’t worry — this is a very common WordPress issue, and it’s usually fixed in less than 5 minutes.
Let’s solve it.
Why WordPress Gets Stuck in Maintenance Mode
Whenever you update:
-
A plugin
-
A theme
-
WordPress core
WordPress temporarily creates a .maintenance file.
If the update:
-
Times out
-
Fails
-
Gets interrupted
That file doesn’t get deleted — and your site stays stuck.
Good news? It’s easy to remove.
Quick Fix #1: Delete the .maintenance File (Most Common Solution)
This fixes the issue 90% of the time.
How to fix:
-
Log in to your hosting control panel
-
Open File Manager (or use FTP)
-
Go to your website’s root folder (public_html)
-
Look for a file called:
-
Delete it
Now refresh your website.
✅ Your site should be back instantly.
Can’t See the .maintenance File?
It might be hidden.
To show hidden files:
-
In File Manager, enable “Show Hidden Files”
-
Or check via FTP
The file is very small, so look carefully.
Quick Fix #2: Clear Cache
If your site still shows maintenance mode:
Clear:
-
Browser cache
-
WordPress cache plugin
-
Hosting cache
-
CDN cache (if using one)
Sometimes it’s just a cached version.
Quick Fix #3: Re-Upload Broken Update Files
If deleting .maintenance didn’t fully fix it, the update may have partially failed.
Example:
If a plugin update caused the issue:
-
Go to
wp-content/plugins -
Delete that plugin folder
-
Reinstall it fresh from WordPress dashboard
If WordPress core update failed:
-
Re-upload fresh WordPress files (except
wp-contentandwp-config.php)
Quick Fix #4: Increase PHP Limits (If Updates Keep Failing)
Sometimes updates fail because of low server resources.
Ask hosting to increase:
-
PHP memory limit
-
Execution time
-
Upload size limit
Or add this to wp-config.php:
Why This Happens Frequently
Maintenance mode problems usually happen when:
-
Internet connection drops during update
-
Hosting server is slow
-
Too many plugins update at once
-
Server memory is low
It’s rarely something serious.
How to Prevent Getting Stuck Again
Here’s how to avoid it in the future:
-
Update one plugin at a time
-
Don’t close browser during updates
-
Avoid updating during peak traffic
-
Keep regular backups
-
Use reliable hosting
Small precautions prevent downtime.
What If Your Admin Panel Is Also Stuck?
If both:
-
Frontend
-
Admin dashboard
Show maintenance mode — deleting .maintenance is still the solution.
If that doesn’t work, contact hosting support and ask:
“Can you check if my last update failed and restore from backup?”
Final Thoughts
WordPress stuck in maintenance mode looks scary — but it’s usually just a tiny file that didn’t delete properly.
Most of the time, all you need to do is:
-
Delete
.maintenance -
Clear cache
-
Reinstall failed updates
And you’re done.

