Remove WordPress Maintenance Mode

The Problem

Your site shows WordPress's maintenance message to every visitor, even though you're not actually updating anything — usually because an update or plugin install was interrupted and left a leftover .maintenance file WordPress never cleaned up.

About this problem

WordPress automatically shows a maintenance page during core, theme or plugin updates by creating a file called .maintenance in your site's root folder, then deletes it the moment the update finishes. If an update is interrupted — a timeout, a lost connection, a crashed server process — that file can get left behind, and WordPress has no way of knowing the update actually finished, so it keeps showing the maintenance message indefinitely.

It's most common on slower hosting during a large update, or when a server restarts mid-update.

What's Included

• Confirming the leftover .maintenance file (or equivalent plugin-based maintenance mode) is the actual cause
• Safely removing it without risking a half-finished update
• Checking that the interrupted update actually completed correctly, not just hiding the symptom
• Confirming the site loads normally for visitors afterwards

What's NOT Included

• Fixing problems caused by the update itself if it genuinely didn't complete (treated as its own issue, flagged if found)
• Disabling maintenance mode you intentionally turned on yourself for ongoing work — that's your call
• Investigating why the server interrupted the update in the first place (can be looked into separately if it keeps happening)

How It Works

1. Check for a leftover .maintenance file in the WordPress root directory via FTP/file manager.
2. Check whether the interrupted update (core, theme or plugin) actually completed by comparing file/version timestamps.
3. If the update didn't finish cleanly, complete or safely roll it back before removing the maintenance file.
4. Remove the .maintenance file (or disable a maintenance-mode plugin if that's the actual cause instead).
5. Reload the site to confirm visitors see the real site again, not the maintenance message.

In practice: you buy the service, send over whatever access or details the job needs, I investigate and do the work, and you confirm it's resolved before we call it done.

Frequently Asked Questions

Why does my WordPress site say "Briefly unavailable for scheduled maintenance" forever?

A WordPress update was interrupted partway through and left behind a leftover .maintenance file that tells WordPress to keep showing that message, even though no update is actually running anymore.

Is it safe to just delete the maintenance file myself?

Usually, but only after confirming the update that triggered it actually finished — deleting the file while an update is genuinely still incomplete can leave your site half-updated.

Will removing maintenance mode undo my update?

No, removing the leftover file doesn't touch the update itself — it's purely the flag WordPress uses to decide whether to show the maintenance message.

Can a plugin cause a stuck maintenance mode instead of WordPress itself?

Yes, some maintenance-mode or coming-soon plugins can get stuck in an "on" state due to a setting or caching issue, separate from WordPress's own update-related maintenance file.

How do I know if an update actually finished before I remove the maintenance file?

Checking the installed plugin/theme/core version numbers against what you expected to update to is the most reliable way, which is exactly what gets checked before anything is removed.