Maintenance Mode replaces your front-end with a branded “we’ll be back soon” page while you make changes. Logged-in administrators keep full access to the site, and search engines see the proper 503 + Retry-After response so your SEO isn’t penalised for the downtime.

What this feature does

When Maintenance Mode is on, AdminEase intercepts every front-end request before WordPress renders it. Visitors who aren’t logged in (or aren’t administrators) see your maintenance page with the headline, message, and colours you configured. Logged-in admins continue to see the site normally so you can keep working.

The maintenance response is properly marked as a 503 Service Temporarily Unavailable with a Retry-After header, which is what search-engine crawlers expect. They’ll come back later instead of treating the page as your real homepage.

A note on visibility

Visitors who are not logged in always see the maintenance page. Logged-in users with the manage_options capability (administrators) bypass it. If you need a different rule, the adminease_maintenance_mode_check_access filter lets you grant or deny access programmatically.

How to enable it

  1. Open AdminEase › Debug. In the WordPress admin menu, click AdminEase, then switch to the Debug tab.
  2. Customise your page first. Before flipping the master switch, fill in the Page Title, Headline, and Maintenance Message so visitors don’t see the defaults. Pick colours that match your brand.
  3. Toggle Enable Maintenance Mode on. AdminEase will start showing the page to non-admin visitors as soon as you save.
  4. Save settings. Open your site in a private window or different browser to verify the page looks right. Logged-in admins won’t see the page in their normal session.
Test in private mode before announcing the window

Because admins bypass Maintenance Mode automatically, your normal browser session won’t show the page. Always test in a private/incognito window or a second browser before assuming the page is live.

Settings reference

Setting What it does Default
Enable Maintenance Mode Master switch. While on, non-admin visitors see the maintenance page; admins keep normal access. Off
Page Title The HTML <title> shown in the browser tab. Also used by search engines and link previews. Site Name — Maintenance Mode
Headline The big text shown at the top of the page. A site name or a short sentence works well. Site Name
Maintenance Message The body of the page. Allows basic HTML (paragraphs, line breaks, bold, italic, links, spans). “We are currently performing scheduled maintenance. Please check back soon!”
Show Site Logo Displays your WordPress site icon (the favicon set under Settings › General) above the headline. On
Primary Color Background and accent colour for the page. Pick something that contrasts with your text colour. #0073aa
Secondary Color Used for borders and secondary UI elements on the page. #23282d
Text Color Body-text colour for the headline and message. #333333
SEO Retry-After (seconds) How long search-engine crawlers should wait before re-checking the page. Sent as the HTTP Retry-After header alongside the 503. Default is 3,600 seconds (one hour). 3600

What the page looks like

Maintenance Mode page rendered on the front-end
The Classic theme rendered with default colours, your site logo, headline, and message.

The page uses a single theme (called Classic) that adapts to the colours you chose. Layout: optional logo at top, headline below it, your message body in the middle, and the page is fully responsive.

What happens behind the scenes

HTTP, hooks, and access checks

Maintenance Mode hooks the WordPress template_redirect action. Before the theme runs, AdminEase checks two things in order: is the visitor logged in with the manage_options capability? and does the adminease_maintenance_mode_check_access filter return true? If either is true, the request continues normally. Otherwise AdminEase sends:

HTTP/1.1 503 Service Temporarily Unavailable
Status: 503 Service Temporarily Unavailable
Retry-After: 3600

The HTML body itself can be filtered with adminease_maintenance_mode_html for full custom templates if the Classic theme isn’t enough.

SEO considerations

Maintenance Mode is designed to be search-engine friendly:

  • 503 status code tells crawlers that the unavailability is temporary, so they don’t deindex your pages.
  • Retry-After header hints when they should come back. One hour is a sensible default. Set it longer for major upgrades.
  • Page title and headline still render, so if a visitor (or social-media link preview) lands on the page, they get useful context instead of a blank screen.

That said, if maintenance mode stays on for days, search engines may eventually deprioritise the affected pages. Use it for short windows.

Troubleshooting

I enabled it but I still see my site

You’re logged in as an administrator. Open a private/incognito window or log out, then revisit the homepage.

My logo is missing

The page uses the WordPress site icon, not the Customizer logo. Set one under Settings › General › Site Icon (older WordPress) or via the Customizer’s Site Identity panel.

HTML in my message is being escaped

The Maintenance Message field allows a small allow-list of safe tags: <br>, <p>, <strong>, <em>, <a>, <span>, and a few more. Other tags are stripped on save for security. If you need a fully custom layout, use the adminease_maintenance_mode_html filter from a small mu-plugin.

Search Console is reporting the maintenance page as my homepage

Check that the 503 response is actually being sent. Some hosts (especially aggressive page-cache layers) cache the response as a 200. Bypass or flush the cache while maintenance mode is on, or configure your CDN to honour the 503.