You updated WordPress, a plugin or a theme, and now your whole site shows: “Briefly unavailable for scheduled maintenance. Check back in a minute.” Except it’s been a lot longer than a minute. Here’s why it happens and how to clear it.
What’s actually going on
When WordPress starts an update, it creates a temporary file called .maintenance in your site’s root folder and shows the maintenance notice to visitors. When the update finishes cleanly, WordPress deletes that file automatically. If the update stalls — a timeout, a memory error, a dropped connection — the file gets left behind and your site stays stuck in maintenance mode.
The fix: delete one file
- Log in to cPanel and open File Manager.
- Navigate to your site’s root folder (usually
public_html). - Turn on Show Hidden Files — the
.maintenancefile starts with a dot, so it’s hidden by default. You’ll find this under Settings in the top-right of File Manager. - Find the file named
.maintenanceand delete it.
Reload your site. The maintenance message is gone.
Finish the interrupted update
Deleting the file clears the message, but the update that failed may be half-done. Log into wp-admin and check Dashboard → Updates. Re-run any update that didn’t complete. If the same update keeps failing, that points to a deeper cause — usually low PHP memory or a timeout.
Why the update failed in the first place
To stop this recurring, address the root cause. Raise the PHP memory limit to 256M and the execution time to 300 seconds so updates have room to finish. Updating one plugin at a time, rather than a batch all at once, also reduces the chance of a mid-update timeout.
Prevent it next time
Always take a backup before major updates, and update during quiet traffic hours. If you’d like updates handled for you on a schedule with a safety net, managed maintenance is something we offer — ask us about it.
