WordPress ‘Briefly Unavailable for Scheduled Maintenance’

Warning Frequency: Common

Error message: Briefly unavailable for scheduled maintenance. Check back in a minute.

During updates, WordPress creates a .maintenance file in the root directory. This file puts the site in maintenance mode while files are being replaced. Once the update finishes, WordPress deletes the file automatically.

If the update process is interrupted — browser closed, server timeout, or PHP max_execution_time reached — the .maintenance file stays, and visitors keep seeing this message.

Common Causes

WordPress update was interrupted (browser closed, server timeout, network error)
Plugin or theme bulk update failed midway
The .maintenance file was not automatically deleted after update completed
Low PHP max_execution_time caused update to time out

How to Fix It

Delete the .maintenance file: Use FTP/SSH to delete .maintenance from the WordPress root directory
Check if the update completed: Go to wp-admin > Dashboard > Updates to see current versions
If update was interrupted: Delete .maintenance, then re-run the update from the dashboard
Increase max_execution_time before updating: Set to 300 seconds in php.ini
Use WP-CLI for updates instead: wp core update && wp plugin update --all (more reliable than browser-based updates)

Frequently Asked Questions

How do I fix 'briefly unavailable for scheduled maintenance'?

Delete the .maintenance file from your WordPress root directory using FTP or SSH. That's it u2014 the site will immediately come back online.

Is my site data safe when this happens?

Yes, your database and content are safe. This message only appears because a file called .maintenance wasn't cleaned up. The worst case is a partially updated plugin, which you can update again from the dashboard.