Maintenance Mode

When you’re updating your site, making major changes, or doing development work, you don’t want visitors seeing a broken experience. This module displays a professional maintenance page to the public while allowing administrators to access the site normally.

Use Cases

  • Put site in maintenance during major updates
  • Show professional “coming soon” page during development
  • Hide the site during content reorganization
  • Display countdown to launch or reopening

How It Works

  1. Enable maintenance mode in settings
  2. Logged-out visitors see the maintenance page
  3. Users with allowed roles access the site normally
  4. Admin bar shows maintenance mode indicator
  5. Optional countdown timer shows expected return time

Quick Enable/Disable

From the module settings:

  1. Toggle Enable Maintenance Mode
  2. Changes take effect immediately
  3. Admin bar shows orange indicator when active

Maintenance mode is highly visible in settings to prevent accidental activation. When enabled, all logged-out visitors see only the maintenance page.

Customization Options

  • Upload a custom logo to display
  • Uses your site logo if none uploaded
  • Centered on the maintenance page

Title & Message

SettingDefault
Title“We’ll Be Back Soon”
Message“Our site is currently undergoing scheduled maintenance…”

Both support HTML for formatting.

Colors

SettingDefaultDescription
Background Color#1e293bPage background
Text Color#ffffffAll text
Accent Color#f59e0bHighlights, timer

Background Image

Instead of solid color:

  1. Switch background type to “Image”
  2. Upload a background image
  3. Image covers full screen with overlay

Countdown Timer

Show visitors when to return:

  1. Enable Show Countdown Timer
  2. Set End Time (date and time picker)
  3. Timer displays days, hours, minutes, seconds
  4. Optional: Auto-disable maintenance when timer ends

Allowed Roles

By default, only administrators can bypass maintenance mode. Customize which roles can access the site:

  • Administrator (always included as fallback)
  • Editor
  • Author
  • Custom roles

Admin Bar Notice

When maintenance mode is active:

  • Admin bar shows colored indicator
  • Visible reminder that the site is in maintenance
  • Quick link to disable

What Visitors See

The maintenance page includes:

  • Your logo (if set)
  • Custom title and message
  • Countdown timer (if enabled)
  • Professional, animated design
  • Mobile-responsive layout

Technical Details

AspectDetail
HTTP Status503 Service Unavailable
Retry-AfterSet based on countdown end time
SEO ImpactMinimal with proper 503 status
CachingTells caches not to cache the page

FAQ

Will search engines penalize my site?No. The module sends HTTP 503 status with Retry-After header, telling search engines the downtime is temporary. Brief maintenance windows have no SEO impact.
Can I let specific IPs bypass maintenance?Currently, bypass is role-based. You must be logged in with an allowed role. IP whitelisting may be added in a future update.
Does the countdown auto-disable maintenance?If you enable “Auto-disable when timer ends,” yes. Otherwise, the timer reaches zero but maintenance mode stays on until you manually disable it.
What if I get locked out?Administrators can always log in at /wp-login.php. If you can log in, you can disable maintenance mode. If you can’t log in, rename or remove the plugin via FTP.
Is the maintenance page customizable with CSS?The colors and logo are customizable in settings. For advanced styling, add custom CSS via the Custom Admin CSS module targeting the maintenance page.

Test your maintenance page by opening an incognito window or logging out. Verify it looks correct before doing real maintenance.

PRO

Get access to all 166 modules with a single license

Upgrade to Pro