WordPress maintenance mode can lock you out of your site during updates. This guide walks you through safe, proven methods to disable it, including deleting the .maintenance file, using plugins, and fixing theme-related triggers—so your site stays live and functional.
Key Takeaways
- Maintenance mode is temporary: It usually appears during core, theme, or plugin updates and should disappear automatically.
- Manual file deletion works: Removing the .maintenance file from your root directory often resolves the issue instantly.
- Plugins can cause false triggers: Some plugins activate maintenance mode incorrectly—deactivating them may fix the problem.
- Theme updates can get stuck: If a theme update fails, switching to a default theme like Twenty Twenty-Four can help restore access.
- Check file permissions: Incorrect server permissions may prevent WordPress from deleting the maintenance file automatically.
- Use FTP or file manager: When locked out of the dashboard, access your site via FTP or cPanel to make changes.
- Prevent future issues: Keep backups and avoid interrupting updates to reduce maintenance mode errors.
How to Fix WordPress Maintenance Mode
If you’ve ever seen a message like “Briefly unavailable for scheduled maintenance. Check back in a minute” on your WordPress site, you’ve encountered maintenance mode. While this feature is designed to protect your site during updates, it sometimes gets stuck—leaving your site inaccessible to visitors and even admins.
Don’t panic. In most cases, fixing WordPress maintenance mode is quick and straightforward. This guide will walk you through several reliable methods to restore your site, whether you’re locked out of the dashboard or just seeing the message unexpectedly. You’ll learn how to remove the maintenance file manually, troubleshoot plugin conflicts, and prevent the issue from happening again.
Let’s get your site back online.
What Is WordPress Maintenance Mode?
Visual guide about How to Fix WordPress Maintenance Mode
Image source: spexo.b-cdn.net
WordPress automatically enables maintenance mode when you update core files, themes, or plugins. During this time, a temporary .maintenance file is created in your site’s root directory. This file tells WordPress to display a maintenance message instead of loading the full site.
Normally, this file is deleted once the update completes. But if the process is interrupted—due to a slow connection, server timeout, or plugin conflict—the file remains, and your site stays in maintenance mode indefinitely.
Method 1: Delete the .maintenance File Manually
The most common fix is removing the .maintenance file from your server. Here’s how:
Step 1: Access Your Website Files
You’ll need to connect to your site via FTP (File Transfer Protocol) or use your hosting provider’s file manager (like cPanel). Popular FTP tools include FileZilla (free) or Cyberduck.
– Log in to your hosting account.
– Open the file manager or launch your FTP client.
– Navigate to the root directory of your WordPress installation (usually public_html or www).
Step 2: Locate and Delete the .maintenance File
Look for a file named .maintenance. It’s a plain text file with no extension.
– If you don’t see it, make sure hidden files are visible. In FileZilla, go to Server > Force showing hidden files. In cPanel, click “Settings” and check “Show hidden files.”
– Right-click the .maintenance file and select “Delete” or “Remove.”
Once deleted, refresh your website. The maintenance message should disappear, and your site should load normally.
Pro Tip: What If the File Reappears?
If the .maintenance file keeps coming back, it means an update is still running or stuck. In that case, wait a few minutes and try again. If the issue persists, move to the next method.
Method 2: Deactivate Problematic Plugins
Visual guide about How to Fix WordPress Maintenance Mode
Image source: diviextended.com
Sometimes, plugins—especially maintenance mode or security plugins—can trigger or prolong maintenance mode incorrectly.
Step 1: Access Your Site via FTP
Since you can’t log into the WordPress dashboard, use FTP or your file manager.
Step 2: Rename the Plugins Folder
– Navigate to wp-content/plugins.
– Rename the “plugins” folder to something like “plugins_old”.
This deactivates all plugins at once. Now, visit your site. If it loads, the issue was caused by a plugin.
Step 3: Reactivate Plugins One by One
– Rename the folder back to “plugins”.
– Go into the folder and rename each plugin folder (e.g., change “wp-maintenance-mode” to “wp-maintenance-mode_old”).
– After renaming one, check your site. If it stays accessible, that plugin was the culprit.
Once identified, either delete the problematic plugin or look for updates or support from the developer.
Method 3: Switch to a Default Theme
A failed theme update can also trigger maintenance mode. If your active theme is causing the issue, switching to a default WordPress theme can help.
Step 1: Access Your Themes Folder
Using FTP or your file manager, go to wp-content/themes.
Step 2: Rename Your Current Theme Folder
Find the folder for your active theme (e.g., “my-custom-theme”) and rename it to “my-custom-theme_old”.
WordPress will automatically fall back to a default theme like Twenty Twenty-Four, Twenty Twenty-Three, or Twenty Twenty-Two—if one is installed.
Step 3: Check Your Site
Visit your website. If it loads, the problem was with your theme. You can then:
– Reinstall the theme properly via the dashboard (once you regain access).
– Or follow our guide on how to install WP themes manually to replace it safely.
If no default theme is installed, you may need to upload one manually via FTP.
Method 4: Check for Stuck Updates
Sometimes, an update starts but never finishes, leaving the site in limbo.
Step 1: Wait and Refresh
Give it 5–10 minutes. Large updates or slow servers can take time.
Step 2: Manually Trigger Update Completion
If waiting doesn’t work, try forcing an update check:
– Add ?force-check=1 to your site URL (e.g., https://yoursite.com/?force-check=1).
– This tells WordPress to recheck for updates and may clear the maintenance state.
Step 3: Use WP-CLI (Advanced)
If you have SSH access, use WP-CLI to clear maintenance mode:
wp maintenance-mode deactivate
This command removes the .maintenance file and deactivates the mode instantly.
Method 5: Fix File Permissions
Incorrect file permissions can prevent WordPress from deleting the .maintenance file.
Step 1: Check Permissions
Using your FTP client or file manager, check the permissions of the .maintenance file and your root directory.
– The file should have 644 permissions.
– Folders should be 755.
Step 2: Correct the Permissions
Right-click the file or folder and select “File Permissions” or “CHMOD.” Set:
– Files: 644
– Folders: 755
Avoid using 777, as it poses security risks.
Troubleshooting Common Issues
Issue: Site Still Shows Maintenance Mode After Deleting File
– Clear your browser cache and try a different browser.
– Check if a caching plugin or server-level cache (like Varnish) is serving the old page. Purge all caches.
– Ensure no other .maintenance files exist in subdirectories.
Issue: Can’t Access FTP or File Manager
– Contact your hosting provider. They can remove the file for you or restart services.
– Use your host’s emergency recovery tools (e.g., SiteGround’s Site Tools, Bluehost’s Advanced File Manager).
Issue: White Screen After Fix
This could indicate a PHP error. Enable debugging by adding this to your wp-config.php file:
define('WP_DEBUG', true);Check the error message and resolve it—often related to a plugin or theme.
How to Prevent Maintenance Mode Issues
Once your site is back, take steps to avoid future problems:
– Keep regular backups: Use plugins like UpdraftPlus or your host’s backup tool.
– Update during low traffic: Schedule updates when fewer visitors are online.
– Use a staging site: Test updates on a copy of your site first.
– Avoid interrupting updates: Don’t close your browser or lose internet during updates.
– Limit active plugins: Too many plugins increase conflict risks. Read our guide on how many plugins you should use for best practices.
Conclusion
WordPress maintenance mode is a helpful feature—until it gets stuck. But with the right approach, you can fix it quickly and safely. Whether you delete the .maintenance file, deactivate a problematic plugin, or switch themes, these methods restore access without risking your content.
Remember: most maintenance mode issues are temporary and fixable. Stay calm, follow the steps, and your site will be back online in minutes. And to keep your WordPress experience smooth, consider using reliable themes and plugins—like those discussed in our article on the best WordPress theme for SEO and speed.
With these tools and tips, you’re ready to handle maintenance mode like a pro.