Home › Knowledgebase › KB-1154

Website Stuck in Maintenance Mode: How to Force WordPress Back Online After a Failed Update

Summary

This guide helps you troubleshoot and resolve: Website Stuck in Maintenance Mode: How to Force WordPress Back Online After a Failed Update. Follow the steps below to fix the issue.

Quick Tip: Need immediate assistance? 💻 Open a Ticket

Common Causes

WordPress automatically places your site into maintenance mode during plugin, theme, or core updates. If an update is interrupted or fails, WordPress may not remove the maintenance file, leaving your website stuck with a "Briefly unavailable for scheduled maintenance" message. This guide explains how to force your WordPress site back online.

Warning: Do not delete core WordPress files or folders such as wp-admin or wp-includes. Only remove the .maintenance file and plugin or theme folders if you are certain they are causing the issue.
Best Practice: Before applying updates to your live production website, we recommend testing them on a staging site first. A staging site is a private copy of your website where you can verify that updates work correctly without affecting your live business website or customer experience.

Quick Fix Steps

  1. Connect to your hosting account via FTP or cPanel File Manager.
  2. Navigate to your website root directory, typically public_html on Australian shared hosting.
  3. Locate the hidden .maintenance file.
  4. Confirm the update has completed or failed before deleting the file. Deleting it prematurely can leave a partial update in place.
  5. Delete the .maintenance file.
  6. Refresh your website in a browser to confirm it is back online.

Detailed Instructions

Using FTP

  1. Open your FTP client (such as FileZilla) and connect to your server using your hosting credentials.
  2. Navigate to your website's root directory. On typical Australian shared hosting, this is public_html.
  3. Look for a hidden file named .maintenance. If you do not see it, enable the option to show hidden files in your FTP client settings.
  4. Right-click .maintenance and select Delete.
  5. Disconnect from the server and visit your website to verify it is loading correctly.

Using cPanel File Manager

  1. Log in to your cPanel account.
  2. In the Files section, click File Manager.
  3. Select Web Root (public_html/www) and ensure Show Hidden Files (dotfiles) is checked, then click Go.
  4. Locate the .maintenance file in the list.
  5. Right-click the file and select Delete, or click the Delete icon in the top toolbar.
  6. Confirm the deletion and refresh your website in your browser.

Troubleshooting

Site still shows maintenance mode

If deleting .maintenance does not resolve the issue, your site may be stuck due to a caching plugin or server-side cache.

.maintenance file not visible or cannot be deleted

If you cannot see the .maintenance file, ensure hidden files are enabled in your FTP client or cPanel File Manager. If the file is visible but cannot be deleted, the issue is likely related to file permissions.

Unable to access WordPress admin

If you cannot log in to /wp-admin after removing the maintenance file, a plugin may be causing a conflict.

  1. Connect via FTP or cPanel File Manager.
  2. Navigate to wp-content/plugins.
  3. Rename the folder of the plugin you were updating when the failure occurred (for example, rename plugin-name to plugin-name.old).
  4. Attempt to log in to your WordPress dashboard again.
  5. Once logged in, go to Plugins > Installed Plugins and reactivate or update the plugin as needed.

Check cPanel error logs

If your website remains offline after removing the maintenance file and clearing caches, check your server error logs for further clues.

  1. Log in to your cPanel account.
  2. In the Metrics section, click Errors.
  3. Review the most recent entries for PHP errors, permission denials, or missing file references.
  4. Note any specific file paths or error codes to include when contacting support.

File permissions

After deleting the .maintenance file, ensure your WordPress files have the correct permissions. Files should typically be 644 and directories 755. Incorrect permissions can prevent WordPress from functioning properly.

Note: Before running updates on a live production site, always create a full backup of your website files and database. This ensures you can restore quickly if an update is interrupted.

If your website remains offline after following these steps, Open a Ticket with our support team for further assistance.

Still Having Issues?

Need more help? If the issue persists after trying these steps, please open a support ticket and our team will assist you.

💻 Open a Ticket