Fix Stuck Maintenance Mode in WordPress Quickly

WordPress gets stuck in maintenance mode when the .maintenance file is not deleted after an update. To fix it, connect to your site via FTP or file manager and delete the .maintenance file from your WordPress root folder.

Why This Happens

When WordPress updates plugins, themes, or core files, it creates a temporary .maintenance file in the root folder. This file tells WordPress to show a maintenance message to visitors. If the update process is interrupted or fails, this file may not get deleted, causing the site to stay stuck in maintenance mode.

php

<?php
// WordPress creates this file during updates
file_put_contents(ABSPATH . '.maintenance', "<?php $upgrading = time(); ?>");
// If update fails or is interrupted, this file remains

Output

<p>WordPress is briefly unavailable for scheduled maintenance. Check back in a minute.</p>

The Fix

To fix the stuck maintenance mode, you need to delete the .maintenance file manually. This file is hidden in your WordPress root directory. Use an FTP client or your hosting file manager to find and delete it. After deletion, your site will return to normal.

wordpress

/* No code change needed in WordPress files. Just delete this file manually: */
// Connect via FTP or file manager
// Navigate to WordPress root folder
// Delete the file named '.maintenance'

Output

<p>Your WordPress site loads normally without the maintenance message.</p>

Prevention

To avoid getting stuck in maintenance mode in the future:

• Always ensure updates complete fully without interruption.
• Use reliable internet and avoid closing browser windows during updates.
• Update plugins and themes one at a time if you have many.
• Keep backups before updating so you can restore if needed.

Related Errors

Other common WordPress update errors include:

• White Screen of Death: Caused by plugin conflicts or memory limits.
• 500 Internal Server Error: Often due to corrupted .htaccess or PHP errors.
• Failed to Write File: Permission issues on server files.

Fixes usually involve checking file permissions, disabling plugins, or restoring backups.

Key Takeaways

Delete the .maintenance file from your WordPress root folder to fix stuck maintenance mode.

Ensure updates complete fully without interruption to prevent this issue.

Use FTP or hosting file manager to access hidden files safely.

Backup your site before updates to recover from problems quickly.

Update plugins and themes one at a time for safer updates.