Skip to content
Errors
6 min readBy Kshitiz Saxena

WordPress Stuck in Maintenance Mode? Here’s the Fix

Your WordPress site is showing a maintenance message and won’t come back. Here’s exactly how to fix it in under two minutes.

Your site is showing "Briefly unavailable for scheduled maintenance. Check back in a minute." — and that minute turned into an hour. This is one of the most common WordPress errors, and the good news is it almost always has a one-step fix. You don't need a developer. You just need to delete a single file.

Why WordPress Gets Stuck in Maintenance Mode

Every time WordPress runs an update — for the core software, a theme, or a plugin, it creates a temporary file called `.maintenance` in the root folder of your site. This file tells WordPress to display the maintenance screen so visitors don't see a half-updated site. Once the update finishes successfully, WordPress deletes the file automatically and your site comes back online.

The problem happens when the update is interrupted. A browser tab closed too early, a server timeout, a network blip, or a PHP memory limit hit mid-update can all leave that `.maintenance` file sitting there with nothing to clean it up. WordPress keeps showing the maintenance screen indefinitely because, as far as it knows, the update is still running.

The Fix: Delete the .maintenance File

The solution is to delete the `.maintenance` file from your site's root directory. There are two ways to do this: through your hosting control panel's file manager, or via FTP (a tool that lets you connect to your server and manage files directly). The file manager route is faster if you have cPanel, Plesk, or a similar dashboard.

Option A: Using Your Hosting File Manager (Easiest)

  1. Log in to your hosting control panel (cPanel, Plesk, or your host's custom dashboard).
  2. Open File Manager and navigate to your site's root folder. This is usually called `public_html`, `www`, or your domain name.
  3. Enable hidden files. In cPanel File Manager, click Settings in the top-right corner and check Show Hidden Files (dotfiles), then click Save.
  4. Look for a file named `.maintenance` in the root folder.
  5. Right-click the file and choose Delete. Confirm the deletion.
  6. Reload your website. It should be back online immediately.

Option B: Using FTP

  1. Connect to your site using an FTP client such as FileZilla and your hosting FTP credentials.
  2. Navigate to your site's root directory (the same `public_html` or `www` folder).
  3. In FileZilla, go to Server > Force showing hidden files so dotfiles become visible.
  4. Find `.maintenance`, right-click it, and select Delete.
  5. Reload your site.

After Deleting the File: Check the Update Finished Properly

Deleting the `.maintenance` file gets your site visible again, but it doesn't confirm the interrupted update completed. Log in to your WordPress dashboard and go to Dashboard > Updates. If any plugins, themes, or core updates still show as available, run them again one at a time. If an update fails repeatedly, that plugin or theme may have a compatibility issue worth investigating.

Also do a quick check of your site's front end: click through a few pages, test any forms or checkout flows, and confirm nothing looks broken. An interrupted update occasionally leaves a plugin in a partially updated state that causes a separate error.

How to Prevent This from Happening Again

  • Never close the browser tab while WordPress is running updates. Wait for the "Update complete" confirmation screen.
  • Increase your PHP memory limit if updates time out frequently. Ask your host to raise it to at least 256MB.
  • Update plugins one at a time rather than using "Update All", it reduces the chance of a timeout mid-process.
  • Use a staging environment to test updates before applying them to your live site. Many managed hosts include this.
  • Keep regular backups so that if an update does go wrong, you can restore quickly.
Cause What Happened How to Avoid It
Browser tab closed Update interrupted before completion Wait for the success screen before closing
Server timeout PHP ran out of time mid-update Ask host to increase PHP max_execution_time
Low PHP memory Update hit the memory ceiling and stopped Raise PHP memory limit to 256MB or higher
Network drop Connection lost during file transfer Update on a stable connection; avoid mobile data

If you find yourself dealing with stuck updates, broken plugins, or site errors on a regular basis, a Website Maintenance & Care Plan takes that off your plate entirely, updates are handled safely, with backups in place before anything runs.

WordPress stuck in maintenance mode almost always comes down to one orphaned file: `.maintenance`. Delete it through your file manager or FTP, verify your updates finished, and your site is back. The whole process takes under two minutes once you know where to look. If you'd rather not dig into server files yourself, or if deleting the file didn't resolve the issue, WordPress support is available to sort it out for you quickly.

Is it safe to delete the .maintenance file?

Yes. The `.maintenance` file is a temporary flag created by WordPress during updates. Deleting it does not remove any site content, database records, or settings. WordPress recreates it automatically the next time an update runs.

My site is still in maintenance mode after deleting the file. What now?

First, clear your browser cache and try a hard refresh (Ctrl+Shift+R on Windows, Cmd+Shift+R on Mac). If the maintenance screen persists, check whether a caching plugin or your hosting's server-level cache is serving a stored version of the page. Clear all caches, then reload. If it still shows, the issue may be something other than the `.maintenance` file, consider reaching out to WordPress support.

Can I get stuck in maintenance mode if I didn't run an update?

It's uncommon, but some third-party maintenance mode plugins create their own lock files or database flags. If you have a plugin like that installed and it was misconfigured or crashed, it could display a maintenance screen independently of WordPress's built-in mechanism. Check your installed plugins and deactivate any maintenance mode plugin to rule this out.

Will visitors see the maintenance screen while I'm fixing this?

Yes, until the `.maintenance` file is deleted, every visitor to your site sees the maintenance message. This is why fixing it quickly matters. The process of connecting via file manager and deleting the file typically takes less than two minutes.

How do I find my site's root folder if I'm not sure which one it is?

The root folder is where WordPress is installed. In most shared hosting setups it's called `public_html`. If you have multiple sites on one account, look for a folder that matches your domain name. Inside it you should see folders named `wp-admin`, `wp-content`, and `wp-includes`, that confirms you're in the right place.

Hand your WordPress site to people who'll keep it running

Move to fully managed hosting and we'll handle speed, security, backups, and updates for you, with free migration and no lock-in. A faster, safer site, and a real person a click away.

We reply to every enquiry within one business day.