How to clear a WordPress maintenance message left after an update
This guide applies to WordPress’s “Briefly unavailable for scheduled maintenance” message after an update. It does not cover a theme’s maintenance page or a maintenance plugin’s visitor screen.
Confirm the update is no longer running
Section titled “Confirm the update is no longer running”If an update is still in progress, let it finish. Removing its maintenance indicator during an active update is not the right first step.
Check whether the message appeared immediately after an interrupted update. A maintenance plugin, hosting cache, or theme setting can produce a different screen with a similar purpose. Identify the actual message before touching files.
Remove a leftover file
Section titled “Remove a leftover file”- Confirm you have a current files-and-database backup and understand how to restore it.
- If the update has stopped and the core message remains, ask your host to help inspect the WordPress root directory. This is the directory containing folders such as
wp-admin. - Locate the leftover file named
.maintenance. A file manager may need to show hidden files to display it. - Remove only that leftover file, following your host’s access method. Do not delete theme, plugin, or WordPress folders to dismiss the message.
WordPress’s troubleshooting documentation identifies this file as the core maintenance indicator. It also advises reviewing the failed update rather than assuming that removing the message completed the upgrade.
Check the result
Section titled “Check the result”Open the public site and dashboard. Check the Updates screen and installed versions to see whether the interrupted update succeeded or needs attention.
If an update must be retried, use the appropriate backed-up process and investigate the interruption if it repeats. See safe theme updates for theme-specific preparation.
If the core file is absent but a maintenance page remains, investigate the plugin, theme option, or cached output instead. Do not keep deleting unrelated files.