Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Setup & site building · Guide

How to Put WordPress in Maintenance Mode

How to Put WordPress in Maintenance Mode

Short answer

To put WordPress in maintenance mode, install a maintenance mode plugin such as WP Maintenance Mode, open Settings, Maintenance Mode, and switch it on. WordPress also turns maintenance mode on by itself during updates, showing a 503 page until the update finishes and the .maintenance file is deleted.

Key takeaways

  • WordPress turns maintenance mode on by itself during updates and deletes the .maintenance file when done.
  • A maintenance plugin lets you design the holding page and let chosen roles bypass it.
  • Maintenance mode returns a 503 status, which tells search engines the downtime is temporary.
  • WordPress ignores a .maintenance file once its timestamp is 10 minutes old.
  • Deleting the .maintenance file from the site root brings a stuck site back at once.
  • Administrators are never locked out by the WP Maintenance Mode plugin.

What is WordPress maintenance mode?

Maintenance mode is a short, planned pause where visitors see a holding page instead of your site while you update it.

WordPress turns it on by itself during core, theme and plugin updates. It creates a small file called .maintenance in your site root and deletes the file when the update finishes.

While the file exists, visitors see the message "Briefly unavailable for scheduled maintenance. Check back in a minute." You can also turn it on by hand with a plugin when you need to work on a live site without visitors seeing half-finished changes.

MethodTime neededNeeds codeBest for
Automatic (core updates)Seconds to minutesNoRoutine updates
PluginAbout 10 minutesNoPlanned work
Manual .maintenance fileAbout 5 minutesA littleEmergencies

How do you put WordPress in maintenance mode with a plugin?

Install a maintenance mode plugin, open its settings, and switch maintenance mode on.

The plugin route takes about 10 minutes and needs no code. WP Maintenance Mode and Site Under Construction is a free plugin on WordPress.org that puts a site under maintenance, coming soon or construction mode.

Its settings live at “Settings → Maintenance Mode”, and it has an admin bar switch that toggles maintenance mode on or off from any page.

  1. Go to “Plugins → Add New” in the dashboard.
  2. Search for “WP Maintenance Mode” and click “Install Now”, then “Activate”.
  3. Go to “Settings → Maintenance Mode”.
  4. Pick one of the 9 bundled templates and edit the headline and message in the live preview.
  5. Toggle “Maintenance Mode” on and save.
  6. Open your site in a private browser window to confirm visitors see the holding page.

Logged-in administrators can still browse the site normally while visitors see the maintenance page.

The plugin also lets you grant access to other roles, such as Editors or Authors, under “Access & Role Bypass”, so your team can keep working. A related guide explains how to add a coming soon page in WordPress if the site has not launched yet.

How do you put WordPress in maintenance mode without a plugin?

Create a file named .maintenance in your site root, and WordPress shows its built-in maintenance page.

This method works when you cannot reach the dashboard, and it takes about 5 minutes with FTP or your host file manager. The file holds one line of PHP with a timestamp, for example <?php $upgrading = 1763798400; ?>. WordPress reads the timestamp and shows the maintenance page while the file exists.

  1. Connect to your site with FTP or your host file manager.
  2. Open the site root folder, the one that holds wp-config.php.
  3. Create a new file named .maintenance (with the leading dot).
  4. Add this line, using the current Unix timestamp: <?php $upgrading = 1763798400; ?>
  5. Save the file and load your site in a private window to confirm the message appears.

To end it, delete the .maintenance file and the site returns at once. You can also drop a file named maintenance.php into wp-content to replace the plain message with your own branded page. Keep a backup of anything you change, and read how to back up a WordPress site before you touch server files.

What do visitors and search engines see?

Visitors see one short message, and search engines get a 503 status that says the downtime is temporary.

WordPress sends an HTTP 503 Service Unavailable response while maintenance mode is active. A 503 tells search engines the outage is short, so they should come back later instead of dropping your pages from results.

The WP Maintenance Mode plugin also sends a Retry-After: 3600 header, which asks crawlers to return in 1 hour, and adds noindex, nofollow tags so the holding page itself is not indexed.

That is why maintenance mode is safer than deleting pages or showing a broken site during an update. A 503 is a clear, temporary signal. A 404 or a half-loaded page sends a much worse message to both visitors and search engines.

How long should maintenance mode last?

Keep it under 1 hour for planned work, and under a few minutes for routine updates.

A normal core, theme or plugin update keeps the site in maintenance mode for only a few seconds to a few minutes. DreamHost notes that WordPress sites "usually stay in maintenance mode for a few seconds to a few minutes" during updates, and the .maintenance file is deleted when the update ends.

If your work needs more time, use the plugin route with a countdown timer and a clear message that says when the site returns.

Long maintenance windows cost traffic and sales, so plan the work first, then switch the mode on. Do the risky part, such as a theme change or a database update, while the holding page is up, then switch it off as soon as you have checked the site.

If you need hours, consider doing the work on a staging copy instead; see how to set up a staging site for WordPress.

How do you let your team see the site during maintenance?

Give their user roles a bypass in the plugin settings, or stay logged in as an administrator.

Administrators are never locked out by the WP Maintenance Mode plugin, and the plugin page states that "Administrators are permanently safeguarded against accidental lockouts". Other roles need an explicit bypass.

In the plugin, open “Access & Role Bypass” and tick the roles that should see the live site, such as Editor or Author. Everyone else sees the holding page.

If you use the manual .maintenance file method, there is no role bypass: every visitor, including logged-in users, sees the maintenance page. That is one more reason to use the plugin for planned work and keep the manual file for emergencies only.

How do you take WordPress out of maintenance mode?

Turn the plugin switch off, or delete the .maintenance file from your site root.

For the plugin route:

  1. Go to “Settings → Maintenance Mode” or use the admin bar switch.
  2. Toggle maintenance mode off and save.
  3. Load the site in a private window to confirm it is live.

For the manual route, delete .maintenance from the site root with FTP or your host file manager. The site returns as soon as the file is gone.

If the site still shows the message after that, clear your browser cache and any caching plugin, then check again in a private window. A cached copy of the maintenance page is the most common reason the message seems to linger.

If you have SSH access, WP-CLI can do the same job with wp maintenance-mode deactivate, as shown in the WP-CLI maintenance-mode command reference.

What if WordPress is stuck in maintenance mode?

Wait 10 minutes first, then delete the .maintenance file if the message is still there.

WordPress ignores a .maintenance file once its timestamp is 10 minutes old, so a stalled update often clears on its own. DreamHost confirms this behaviour and notes that a message lasting longer usually means a cached error page, a repeated failed update, or a maintenance plugin is holding the screen up.

If you started an update a few minutes ago and the tab is still open, let it finish before you touch anything.

  1. Wait 10 minutes, then reload the site in a private window.
  2. If the message is still there, connect with FTP or your host file manager.
  3. Open the site root and turn on “Show Hidden Files”, because .maintenance is a hidden dotfile.
  4. Delete .maintenance and reload the site.
  5. Open “Dashboard → Updates” and finish or re-run the update that was interrupted.

If a plugin is causing the screen, deactivate it from the dashboard if you can reach it. If you cannot, rename its folder inside wp-content/plugins with FTP, which deactivates it at once. The full fix is covered in the guide on how to fix stuck in maintenance mode.

What mistakes should you avoid?

Do not leave maintenance mode on longer than needed, and never edit live files without a backup.

The 5 mistakes below cause most maintenance mode problems:

  • Starting a big update without a backup, so a failed update leaves the site stuck.
  • Closing the browser tab mid-update, which leaves the .maintenance file behind.
  • Using a coming soon mode (HTTP 200) for a live site update, which tells search engines the holding page is a real page.
  • Forgetting that the manual .maintenance file locks out logged-in users too.
  • Deleting the wrong file in the site root while looking for .maintenance.

After every update, load the homepage and one inner page in a private window. If both load, maintenance mode is off and the update is done.

Frequently asked questions

How long does WordPress maintenance mode last?

A few seconds to a few minutes for a normal update. WordPress creates the .maintenance file when an update starts and deletes it when the update ends. For planned work with a plugin, keep it under an hour and tell visitors when the site will return.

Can I still see my site while it is in maintenance mode?

Yes. Administrators can browse the site normally while visitors see the maintenance page, and the plugin lets you grant access to other roles such as Editors or Authors. With the manual .maintenance file method there is no bypass, so everyone sees the maintenance page.

Does maintenance mode hurt SEO?

No. Maintenance mode returns a 503 status, which tells search engines the downtime is temporary, and the plugin adds a Retry-After header and noindex tags. A short maintenance window should not hurt rankings. Coming soon mode uses a 200 status instead, so use maintenance mode for updates to a live site.

What do I do if WordPress is stuck in maintenance mode?

Wait 10 minutes, because WordPress ignores a .maintenance file once its timestamp is 10 minutes old. If the message is still there, delete the .maintenance file from your site root with FTP or your host file manager, then finish or re-run the interrupted update.

What is the difference between maintenance mode and coming soon mode?

Maintenance mode is for short work on a live site and returns a 503 status. Coming soon mode is for a site that has not launched yet and returns a 200 status so search engines can see the launch page. Use maintenance mode for updates and coming soon mode before launch.

Sources

  1. WP Maintenance Mode & Site Under Construction WordPress.org
  2. How To Fix Briefly Unavailable For Scheduled Maintenance DreamHost
  3. Coming Soon Maintenance Mode WordPress.org
  4. Simple Maintenance Mode White Screen WordPress.org
  5. wp maintenance-mode WordPress Developer Resources
  6. WP-CLI WP-CLI

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.