If your WordPress site shows “Briefly unavailable for scheduled maintenance. Check back in a minute.” and it’s been more than a few minutes, WordPress is stuck in maintenance mode.

This happens when an update (core, plugin, or theme) starts but doesn’t finish cleanly. WordPress creates a .maintenance file before updating and removes it when done. If the update crashes or times out, the file stays behind and locks the site.

The Fix (30 seconds)

Delete the .maintenance file from your WordPress root directory. That’s it.

Option 1: cPanel File Manager

  1. Log in to cPanel and open File Manager
  2. Navigate to your site’s root directory (usually public_html/)
  3. Look for a file named .maintenance
    • If you don’t see it, click Settings in the top right and check “Show hidden files”
  4. Select the file and click Delete
  5. Visit your site – it should be back

Option 2: SSH 

  cd /home/username/public_html
ls -la .maintenance    # confirm it exists
rm .maintenance        # delete it

Replace username with your actual cPanel username.

Option 3: FTP/SFTP

  1. Connect with your FTP client (FileZilla, Cyberduck, etc.)
  2. Navigate to your site’s root folder
  3. Enable “Show hidden files” in your client’s settings
  4. Find and delete .maintenance

Why Did This Happen?

Common causes:

  • PHP timeout. The server ran out of time during a large update. This is common on shared hosting with strict resource limits.
  • Memory limit. WordPress ran out of memory mid-update.
  • Simultaneous updates. Updating multiple plugins at once increases the chance of a timeout.
  • Lost connection. Your browser tab was closed or your internet dropped during an update.

Preventing It in the Future

  • Update plugins one at a time instead of bulk-updating everything at once
  • Make sure your PHP memory limit is at least 256MB (check in cPanel > PHP Configuration)
  • Keep your hosting resources healthy. If you’re hitting CloudLinux limits regularly, consider upgrading your plan
  • Don’t close the browser tab during updates – wait for the “Update successful” message

Still Not Working?

If removing .maintenance doesn’t fix the site, the update may have left files in a broken state:

  1. Check wp-content/plugins/ for any partially updated plugin folders
  2. Try renaming the plugins folder temporarily:
      mv wp-content/plugins wp-content/plugins_backup
  3. Visit the site – if it loads, one of the plugins is the problem
  4. Rename the folder back and reactivate plugins one by one to find the culprit

Last updated 19 Apr 2026, 23:46 +0300. history

Was this page helpful?