Skip to content

WordPress Stuck in Maintenance Mode? Fix It in 5 Minutes

Seeing "Briefly unavailable for scheduled maintenance" for too long? Delete the .maintenance file, finish the update safely, and stop it happening again.

Person updating a website on a laptop

Your site shows “Briefly unavailable for scheduled maintenance. Check back in a minute.” A minute passes, then ten, then an hour, and the message is still there. WordPress is stuck in maintenance mode.

This is one of the easiest WordPress problems to fix, usually in under five minutes. Here is why it happens and how to get out of it safely.

Why WordPress gets stuck in maintenance mode

When WordPress updates core, plugins, or themes, it creates a temporary file called .maintenance in the site’s root folder. While that file exists, visitors see the maintenance message. When the update finishes, WordPress deletes the file.

If the update is interrupted (the browser tab was closed, the server timed out, PHP ran out of memory, or many updates ran at once), the file is never removed and the site stays in maintenance mode.

Step 1: Delete the .maintenance file

  1. Open your hosting control panel’s File Manager, or connect with SFTP/FTP.
  2. Go to the folder where WordPress is installed, the one that contains wp-config.php, wp-admin, and wp-content.
  3. Turn on “show hidden files” (files starting with a dot are hidden by default).
  4. Delete the file named .maintenance.
  5. Reload your site in a private window.

If you use WP-CLI, the same fix is one command: wp maintenance-mode deactivate.

Step 2: Check that the update actually finished

Deleting the file brings the site back, but the update that was interrupted may be incomplete. Log in to wp-admin and go to Dashboard → Updates.

  • If updates are still listed, run them again, one at a time.
  • If a plugin now shows errors or is missing, reinstall it from Plugins → Add New or upload a fresh copy.
  • If the site shows “There has been a critical error” after removing the file, a half-installed update broke something. Follow our guide to fixing the WordPress critical error.

Step 3: Clear caches

Caching plugins and CDNs can keep serving the maintenance page even after the file is gone. Purge your caching plugin and your CDN (for example Cloudflare) if visitors still see the message.

Step 4: Fix a broken core update

If a WordPress core update was interrupted and wp-admin will not load properly, download the same WordPress version from WordPress.org and re-upload the wp-admin and wp-includes folders. Do not overwrite wp-content or wp-config.php.

How to avoid getting stuck again

  • Update plugins in small batches rather than all at once.
  • Keep the browser tab open until updates finish.
  • Make sure your PHP memory limit is at least 256 MB, so updates do not run out of memory.
  • Take a backup before major updates, and test big updates on a staging copy first.
  • If your host’s server is frequently slow during updates, consider a better hosting plan.

Want maintenance mode on purpose?

If you actually want to show a maintenance page while you work on the site, use a dedicated maintenance or coming-soon plugin rather than the .maintenance file. These let you show a branded page, keep the site visible to logged-in admins, and send the correct HTTP 503 status so search engines know the downtime is temporary.

Rather have someone handle updates for you? Our WordPress Maintenance plans run updates safely every week with backups first. If something is broken right now, our WordPress Fix is a fixed $49. Request a fix.

Frequently asked questions

Is it safe to delete the .maintenance file?

Yes. It is a temporary file WordPress creates during updates. Deleting it only ends maintenance mode. It does not affect your content or settings.

I cannot find the .maintenance file. What now?

Make sure hidden files are visible and that you are in the WordPress root folder. If the file is truly missing and the message remains, a maintenance or coming-soon plugin or a cache may be showing it. Clear caches and check your plugins.

Does maintenance mode hurt SEO?

A few minutes does not. WordPress sends a 503 “temporarily unavailable” status, which tells search engines to come back later. Being stuck for days can affect rankings, so fix it quickly.

Still Stuck? We Can Fix It for You

Tell us what is going on. We confirm the scope and price before any work begins.