Skip to main content

wp maintenance-mode status

Overview

Quickly check whether maintenance mode is currently enabled — useful in deployment scripts, post-update verification, and monitoring dashboards.

What It Does​

wp maintenance-mode status checks whether the .maintenance file exists in the WordPress root and whether its timestamp indicates active maintenance. Returns a clear status string.

Syntax​

wp maintenance-mode status

Output when active:

Maintenance mode is active.

Output when inactive:

Maintenance mode is not active.

Basic Usage​

wp maintenance-mode status

Real-World Scenarios​

Scenario 1: Pre-deploy safety check (abort if already in maintenance)​

STATUS=$(wp maintenance-mode status)
if [[ "$STATUS" == *"active"* ]]; then
  echo "ERROR: Maintenance mode is already active. Aborting deploy."
  exit 1
fi

echo "Proceeding with deployment..."

Scenario 2: Monitor all sites for stale maintenance mode​

for url in $(wp site list --field=url); do
  STATUS=$(wp maintenance-mode status --url="$url")
  echo "$url: $STATUS"
done

Scenario 3: Health check in CI/CD pipeline​

# After deployment, verify the site is back online
wp maintenance-mode deactivate
STATUS=$(wp maintenance-mode status)

if [[ "$STATUS" == *"active"* ]]; then
  echo "FAIL: Maintenance mode still active after deploy!"
  exit 1
else
  echo "PASS: Site is live."
fi

Quick Reference​

wp maintenance-mode status             # Check state
wp maintenance-mode activate           # Enable
wp maintenance-mode deactivate         # Disable

Next Steps​