Home / WordPress / WordPress Stuck in Maintenance Mode: Fix

WordPress Stuck in Maintenance Mode: Fix

Fix the maintenance mode screen by removing the .maintenance file and completing a safe update workflow.

Views: 23 Unique: 16 Updated: 2026-03-18

What this problem is

WordPress shows: Briefly unavailable for scheduled maintenance and never returns to normal.

Why it happens

  • An update process was interrupted (timeout, connection drop)
  • File permissions prevented update completion
  • Low PHP limits caused the update to fail mid-way

Prerequisites

  • FTP/File Manager access

Diagnosis

Check if the file .maintenance exists in the WordPress root (same level as wp-config.php).

Detailed steps

Step 1) Delete the .maintenance file

Remove .maintenance from the site root.

Expected result: the site loads normally again.

Step 2) Verify core folders are intact

Confirm wp-admin and wp-includes are present and not partially updated.

Step 3) Re-run the failed update (recommended)

  • Update WordPress core from wp-admin if accessible, or
  • Use a manual update via FTP if wp-admin is not accessible

Expected results

  • Maintenance mode cleared
  • Updates complete without leaving the site in a broken state

What to do if it fails

  • Check file ownership/permissions and retry
  • Review wp-content/debug.log and hosting error logs
  • Disable plugins temporarily if they interfere with updates

Best practices

  • Update during low-traffic windows
  • Keep backups and use staging when possible
  • Ensure sufficient PHP timeouts and memory before updating
Back to category