Skip to main content

How to Remove a Stuck WordPress Maintenance Mode Message

If your website displays a message stating that it is currently under maintenance, it is likely stuck in "Maintenance Mode." This occurs when a WordPress update, plugin installation, or theme change is interrupted, leaving a temporary file in your...

If your website displays a message stating that it is currently under maintenance, it is likely stuck in "Maintenance Mode." This occurs when a WordPress update, plugin installation, or theme change is interrupted, leaving a temporary file in your website's directory.

Before you begin

You will need:

  • WordPress Site Administrator access

  • Access to your website's files via an FTP client or a File Manager (such as the one provided in your hosting control panel)

Remove the maintenance file

To clear the maintenance mode, you must delete the .maintenance file from your WordPress root directory.

  1. Connect to your site's files using an FTP client or your hosting control panel's File Manager.

  2. Navigate to the root directory of your WordPress installation (usually the public_html or www folder).

  3. Locate the file named .maintenance.

  4. Delete the .maintenance file.

Note: This file is a temporary file created by WordPress during updates. Deleting it will not affect your site's content, themes, or plugins.

Confirm the result

  • Refresh your browser to view your website.

  • The "Briefly entering maintenance mode" message should be gone, and your site should load normally.

  • If you were in the middle of an update, you may need to re-run the update for the specific plugin or theme that was interrupted.

If the site still shows a maintenance message

If the site remains in maintenance mode after deleting the .maintenance file, it may be caused by a caching layer.

  • Clear your browser cache: Perform a hard refresh (Ctrl+F5 on Windows or Cmd+Shift+R on Mac).

  • Clear server-side cache: If you use a caching plugin (such as LiteSpeed Cache or WP Rocket) or a CDN (such as Cloudflare), clear the cache through the respective plugin settings or service dashboard.

  • Check for a "Maintenance" plugin: Some plugins specifically manage "Maintenance Mode." If you have one installed, check its settings to ensure it is disabled.

Limitations

This procedure only removes the standard WordPress maintenance flag. If your site is inaccessible due to a plugin conflict or a "White Screen of Death," you may need to follow specific troubleshooting steps for those issues.

Did this answer your question?