WordPress maintenance mode shows visitors a temporary “back soon” page while you work on the site behind it. WordPress turns on its own version automatically during updates, and you can turn it on yourself when you need a planned window for bigger work. This guide covers when to use it, three ways to switch it on, how to keep it safe for search, and how to fix a site that gets stuck.
Quick answer: WordPress maintenance mode replaces your site with a temporary notice while work is under way. WordPress uses it automatically during updates, showing “Briefly unavailable for scheduled maintenance. Check back in a minute.” with a 503 status. To use it yourself, pick a plugin, WP-CLI or your page builder’s setting, keep the window short, and make sure the page returns a 503 so search engines treat the outage as temporary.
What is WordPress maintenance mode?
When WordPress updates its core, plugins or themes, it creates a file called .maintenance in the site’s root folder. While that file exists, visitors see the message “Briefly unavailable for scheduled maintenance. Check back in a minute.” WordPress sends that page with a 503 “Service Unavailable” status and a Retry-After: 600 header, then deletes the file when the update finishes.
There’s a built-in safety limit. The file holds a timestamp, and WordPress treats maintenance as over once that timestamp is ten minutes old, even if the file is still there. These details come from WordPress’s own code reference for wp_maintenance() and wp_is_maintenance_mode().
When to use WordPress maintenance mode, and when not to
When you do need a planned window, WordPress maintenance mode is the tool that tells visitors and search engines what’s happening. It suits short jobs that can’t happen while the site is live: a major platform upgrade, a database change, or switching a theme on a site that can’t be cloned.
It’s the wrong tool when the work can be done somewhere else first. Testing on a staging copy and pushing the finished change keeps the site online the whole time. And on a store or booking site, every minute in maintenance mode is a minute nobody can buy or book, so keep windows short and schedule them for your quietest hours.
3 ways to turn on WordPress maintenance mode
1. A maintenance mode plugin
The simplest route for most sites. Search the WordPress.org plugin directory for “maintenance mode”, install one, and use its settings to switch the mode on and design the page. Before relying on any plugin, check two things in its settings: that logged-in administrators can still see the site, and that the page returns a 503 status. Remember to switch it off when you’re done.
2. WP-CLI
If you have command-line access to your server, WP-CLI’s maintenance-mode command handles it in one line each, run from your WordPress folder:
- wp maintenance-mode activate turns maintenance mode on
- wp maintenance-mode status shows whether it’s on
- wp maintenance-mode deactivate turns it off
- wp maintenance-mode is-active returns a result for use in scripts
These commands come from the official WP-CLI documentation.
3. Your page builder’s setting (Elementor example)
Some page builders include WordPress maintenance mode, so you don’t need another plugin. In Elementor, go to Elementor > Editor > Tools, open the Maintenance Mode tab, and set Choose Mode to Maintenance for a live site you’re working on. You choose which roles can still see the site and which template visitors see. According to Elementor’s documentation, the Coming Soon option is different: it tells search engines the site is working normally and can be indexed, so it’s for sites that haven’t launched yet.
Customize your WordPress maintenance page
The default WordPress maintenance page is a plain line of text. Plugins and page builders let you design your own WordPress maintenance page with your logo, a short explanation, an expected return time, and a way to contact you for anything urgent.
For WordPress’s built-in mode, WordPress’s code reference notes that the default message can be replaced with a drop-in file named maintenance.php placed in the wp-content folder. WordPress loads that file instead of sending its own 503 response, so the file must send the 503 status and a Retry-After header itself.
Keep WordPress maintenance mode safe for search engines
A maintenance page served with a normal 200 status can be indexed as if it were your real content. Google’s guidance is to return a 503 status for the whole site while it’s unavailable, which keeps the temporary page out of the index. Google also recommends:
- adding a Retry-After header with a best-effort date or duration
- never returning a 503 for your robots.txt file, because that blocks crawling
- keeping urgent closures short: one to two days
Google notes that Googlebot retries 503 pages for up to about a week before treating them as a permanent error, which can drop pages from search results. WordPress maintenance mode is meant for hours, not days.
Google also suggests confirming the 503 with curl or a similar tool. Your browser’s developer tools show the status code too, in the Network tab.
How to fix WordPress stuck in maintenance mode
If an update is interrupted, WordPress maintenance mode can get stuck: the .maintenance file is left behind and the site keeps showing “Briefly unavailable for scheduled maintenance”. This fix needs access to your site’s files, through your host’s file manager, SFTP or SSH. If you can, take a backup first.
- Wait ten minutes and reload. WordPress ignores a .maintenance file once its timestamp is ten minutes old, so a brief stall often clears itself.
- Take a backup, through your host’s dashboard if the site itself won’t load.
- Connect to your site’s files with your host’s file manager, SFTP or SSH.
- Open the WordPress root folder, the folder WordPress is installed in.
- Show hidden files. .maintenance starts with a dot, so many file managers hide it by default.
- Delete the .maintenance file. If you have WP-CLI, wp maintenance-mode deactivate does the same job.
- Clear any caches (plugin, host and CDN) and reload the site in a private browser window.
- Check the update that failed. Log in, look for the plugin, theme or core update that was interrupted, and run it again or roll it back.
If the site still shows the message, the page may be coming from a cache or from your host rather than WordPress. Check your host’s error log for a failed update, and contact your host before changing anything else.
After the window: switching WordPress maintenance mode off
The most common problem isn’t technical: maintenance mode gets left on. Set a reminder when you switch it on, and finish every window with the same routine:
- Switch WordPress maintenance mode off in the plugin, WP-CLI or page builder you used.
- Clear your plugin, host and CDN caches.
- Load the site in a private browser window and test a page, a form and anything that takes payments.
- Check Google Search Console over the next few days for new crawl errors.
To make windows less likely to go wrong, update plugins in small batches rather than all at once, so a conflict is easy to trace.
Maintenance mode vs a coming soon page
They look similar but say different things to search engines. WordPress maintenance mode is for a live, indexed site that’s temporarily unavailable, and it should return a 503. A coming soon page is for a site that hasn’t launched; Elementor’s documentation describes its Coming Soon mode as telling search engines the site is working normally and can be indexed.
Frequently asked questions
What is WordPress maintenance mode?
WordPress maintenance mode is a temporary state in which visitors see a “back soon” page instead of the site. WordPress turns it on automatically during updates, and you can turn it on yourself with a plugin, WP-CLI or a page builder setting.
How long does WordPress stay in maintenance mode during an update?
Usually only while the update runs. WordPress also treats maintenance as over once the .maintenance file’s timestamp is ten minutes old, so a stalled update normally clears itself within ten minutes.
Does WordPress maintenance mode hurt SEO?
Not if it’s short and returns a 503 status. Google treats a 503 as temporary, but recommends keeping urgent closures to one or two days, and treats 503 pages as a permanent error if they last about a week.
Can I put WordPress in maintenance mode without a plugin?
Yes. With command-line access, run wp maintenance-mode activate through WP-CLI and wp maintenance-mode deactivate when you’re done. Some page builders, such as Elementor, also include a maintenance mode setting.
Why does my WordPress maintenance page still show after an update?
Usually a leftover .maintenance file from an interrupted update, or a cached copy of the page. Follow the steps above to remove the file and clear your caches.
The bottom line
WordPress maintenance mode is a short-term tool: use it for a planned window you can’t avoid, keep it to a 503, switch it off promptly, and know how to remove a stuck .maintenance file. If you’d rather not handle updates and windows yourself, see what our maintenance service covers.
