If your website displays “Briefly unavailable for scheduled maintenance. Check back in a minute,” WordPress is performing an update. The message should disappear automatically, but an interrupted update can leave the site stuck in maintenance mode.
The usual fix is deleting a temporary file named .maintenance from the WordPress root directory. Follow these steps before trying more aggressive repairs.
Why WordPress Gets Stuck in Maintenance Mode
WordPress creates a temporary .maintenance file while updating its core software, plugins, or themes. WordPress normally deletes the file when the update finishes.
The file may remain when:
- The update times out or is interrupted.
- The browser is closed during an update.
- The server reaches its memory or resource limit.
- Several updates are run simultaneously.
- A plugin or theme update fails.
- File permissions prevent WordPress from completing the process.
1. Wait a Few Minutes
Do not immediately delete files if an update is still running. Wait five minutes and reload the website in a private browser window.
If the message remains and no update is actively running, continue with the next step.
2. Create a Backup
If your host provides automatic backups or restore points, confirm that a recent backup is available. A stuck update may have left a plugin, theme, or WordPress core partially updated.
Do not restore a backup yet. First remove the maintenance file and check whether the website returns.
3. Open the WordPress Root Directory
Access your website files using one of these methods:
- cPanel File Manager
- Your hosting provider’s file manager
- SFTP
- FTP
Open the directory containing wp-admin, wp-content, wp-includes, and wp-config.php. This is the WordPress root directory.
4. Show Hidden Files
Files beginning with a period are often hidden. Enable the option to show hidden files or dotfiles in your file manager or FTP program.
Look for:
.maintenance5. Delete Only the .maintenance File
Delete the .maintenance file from the WordPress root directory. Then clear your website cache and reload the website.
Do not delete the entire WordPress directory or similarly named files. The target is one temporary file named exactly .maintenance.
If the site loads normally, log in to WordPress and verify whether the attempted update completed.
6. Check for a Failed Plugin or Theme Update
If the website changes from the maintenance message to a critical error, blank screen, or broken layout, the interrupted update may have damaged the plugin or theme being updated.
Check the Plugins and Themes screens for failed updates. Reinstall or update the affected component individually. Avoid selecting every available update at once.
If you now see a fatal error, follow my guide to fixing the WordPress critical error once it is published in this troubleshooting library.
7. Check WordPress Core Files
If the interruption happened during a WordPress core update, visit Dashboard Updates and run the reinstall option. This replaces WordPress core files without deleting your content.
Create a backup before manually replacing files. Never overwrite wp-content or wp-config.php with files from a fresh WordPress download.
8. Review Hosting Resource Limits
Repeated maintenance mode failures often point to a hosting problem rather than WordPress itself. Ask your host to check:
- PHP memory limits
- Execution time limits
- Available disk space
- File ownership and permissions
- Server error logs from the failed update
Can Maintenance Mode Affect SEO?
A short maintenance period is normal. A site stuck offline for hours or days can prevent search engines and visitors from accessing its pages.
After recovery, test several important URLs and review Google Search Console for server errors. Confirm that pages return a successful 200 status code.
How to Prevent WordPress From Getting Stuck Again
- Create a backup before running updates.
- Update plugins and themes in smaller groups.
- Keep the browser tab open until updates finish.
- Remove abandoned plugins and unused themes.
- Run major updates on staging first.
- Use ongoing WordPress website maintenance.
Need Help Recovering Your WordPress Website?
If removing the maintenance file reveals another error or the website remains unavailable, stop before replacing random files.
