• Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar
Carrie Dils

Carrie Dils

WordPress Developer, Consultant, and Instructor

  • About
    • Work with Me
    • Around the Web
    • Media Kit
  • Blog
  • Web Development Courses
  • Freelancing Courses

Quick Fix: Briefly unavailable for scheduled maintenance.

Originally published on August 11, 2015 by Carrie Dils 165 Comments
Last updated on January 19, 2021

Ever tried updating some WordPress plugins and had the screen freeze? Did you refresh madly only to end up with this message?

Briefly unavailable for scheduled maintenance. Check back in a minute.

Well don’t panic. The fix is easy and I’ll walk you through it.

First things first…

Why does this error happen?

When you go to update a plugin, WordPress puts itself in a temporary maintenance mode state. When you see the “Briefly unavailable…” message, that’s a WordPress-generated notification that alerts any visitors about what’s happening with your site.

Let’s say you’re updating your plugins and someone happens to visit your site during the process. They’d see that notification message, say “okay” to themselves, and hopefully refresh the page in a minute.

This message is normal behavior.

What’s not normal is when your server has a slow response time or for some reason the update script is interrupted (or times out). In that case, the friendly notification morphs into a moment of dread and panic.

How to fix it.

When this happens, WordPress generates a .maintenance file in the root directory of the installation. With normal behavior, the update script completes and WordPress auto-removes the .maintenance file. In the case of an interruption of some sort, this file doesn’t get deleted and the message won’t go away.

The answer? Delete it manually.

Here are the steps:

  • Log into your web server via FTP or your web host’s control panel.*
  • Locate the root of your WordPress install (this is where you’ll find folders for wp-content, wp-admin, and wp-includes)
  • Look for a file called .maintenance
  • Delete it
  • Refresh your WordPress site and sigh a giant sigh of relief that everything’s normal again.

* If you don’t have this information for some reason, take a moment to slap yourself, then run around in a state of mild hysteria until you can reach someone who can give you this information. And then slap yourself again if you ever consider editing your WordPress site without this information in hand.

Update: If you don’t see a .maintenance file, make sure it’s not hidden. Here’s how to show hidden files on MacOS. Here’s how to show hidden files on Windows.

Is there still not a .maintenance file there? Try this out . (thanks lifanovsky for that tip!)


Get Beaver Builder Now!

Up your game by using using a staging site.

A staging site is an exact duplicate of your live site – it’s a place where you can install new plugins or try out different configurations without the danger of tanking your live site. Once you’ve made any changes you want to your staging site (and are sure everything is working), you can “push” it to your live site.

If you’re not using a staging site, I strongly recommend using one so that you can avoid problems like the one I talked about in this post.

A quality web host typically has site staging available. My favorites are WP Engine and Flywheel. If you’d like to see things in action, here’s a tutorial on how to use Flywheel staging sites and another one on how to work with WP Engine legacy staging.

If your web host doesn’t offer staging or you prefer to develop locally, I really dig Local WP. And bonus — It’s free.

Filed Under: WordPress Tutorials

Reader Interactions

Comments

  1. Satish says

    May 25, 2020 at 1:49 am

    Thank you so much this save my day. I was so damn worried. It was an easy fix, I was unnecessarily worrying so much. 🙂

    Reply
  2. Trung tâm tiếng Đức says

    May 25, 2020 at 4:17 pm

    Thanks so much for your simple solution. I have just updated 3 plugins and I had this error.

    Once again, thanks for your tip and hope that you will write more helpful articles in future.

    Reply

    Reply
  3. Sumama Mithani says

    September 25, 2020 at 8:32 am

    You truly spared me for sure. I had some live traffic on the site while I attempted to refresh the module. Your directions were great, including the part where you said not to freeze

    Reply
    • Carrie Dils says

      September 29, 2020 at 5:45 pm

      Glad to hear it!

      Reply
  4. Ahsan says

    January 14, 2021 at 6:42 am

    Great. thank u so much.

    Reply
« Older Comments

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

Primary Sidebar

Search

Heya, I’m Carrie Dils

Carrie Dils chillin at the beach

Articles

  • Business
  • Front-End Development
  • Genesis Framework
  • Mental Health
  • Web Accessibility
  • WordPress Tutorials

Things I Love ❤️

My Tech Toolbox

Favorite Business Books

Powered by
  • My Courses on LinkedIN Learning
  • The Fearless Freelancer®

© 2022 CWD Holdings LLC