How to Fix Briefly Unavailable for Scheduled Maintenance in WordPress

When you update a plugin, theme, or WordPress core, your site is temporarily put into maintenance mode. During this brief period, visitors see a message that says:

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

Usually, this message disappears after a few seconds once the update is complete. However, if the update is interrupted (due to a slow server connection, closing the browser tab, or a script timeout), your site might get stuck in maintenance mode.

Why Does Your Site Get Stuck?

When an update begins, WordPress creates a temporary file called .maintenance in the root folder of your website. If the update completes successfully, WordPress deletes this file. If it fails or is interrupted, the file is left behind, and your site remains locked in maintenance mode.

How to Fix It

Fixing this is incredibly simple and requires no coding knowledge.

The Fix:

  1. Connect to your website via an FTP client (like FileZilla) or use the File Manager provided in your hosting control panel (e.g., cPanel).
  2. Navigate to the root folder of your WordPress installation (this is usually public_html or the folder where your wp-config.php file is located).
  3. Ensure that your FTP client is set to show hidden files (files starting with a dot).
  4. Look for the file named .maintenance.
  5. Delete the .maintenance file.

That’s it! Once the file is deleted, refresh your website, and it should load normally.

Preventing This in the Future

To minimize the chances of getting stuck in maintenance mode again:

  • Update plugins one by one: Instead of selecting all plugins and clicking “Update”, try updating them individually, especially if you are on a slow shared server.
  • Don’t close the browser: When an update is running, wait until WordPress explicitly tells you it has completed before navigating away.
  • Upgrade hosting: If this happens frequently, it’s a sign your server is timing out and struggling to handle basic tasks. Consider upgrading your hosting plan.

How to Customize the Maintenance Message

If you want to provide a better user experience during updates, you can create a custom maintenance page.

Create a file named maintenance.php inside your /wp-content/ folder with your custom HTML/CSS. WordPress will automatically display this file instead of the default plain-text message when an update is occurring.