Wordpress stuck in maintenance mode after failed update
Summary
This guide helps you troubleshoot and resolve: Wordpress stuck in maintenance mode after failed update. Follow the steps below to fix the issue.
Common Causes
WordPress places your site into maintenance mode whenever an automatic update is running. This is a normal safety feature that prevents visitors from seeing a partially updated site. However, if an update is interrupted—such as by a timeout, connection drop, or server error—WordPress may fail to remove the maintenance flag. When this happens, your website and admin dashboard remain inaccessible until the temporary maintenance file is removed.
If you host with us, you don't need to do this yourself — just Open a Ticket and our Brisbane team will get it sorted.
What Is the Maintenance File?
When WordPress begins an update, it creates a hidden file named .maintenance in the root folder of your installation. This file tells WordPress to display a brief maintenance message to visitors. If the update completes successfully, WordPress deletes this file automatically. If the update fails, the file often remains behind, keeping your site stuck in maintenance mode.
File Manager is the browser-based tool inside your hosting control panel that lets you view and edit website files without installing extra software. FTP (File Transfer Protocol) is a method of connecting to your hosting server using a separate program on your computer to manage files.
Remove the File via cPanel File Manager
- Log in to your cPanel hosting control panel.
- Go to Files > File Manager.
- In File Manager, click Settings (usually in the top-right corner).
- Tick the box for Show Hidden Files (dotfiles) and click Save.
- Navigate to the folder containing your WordPress installation. This is typically
public_html,www, or a folder named after your domain. - Look for a file named
.maintenancein the file list. - Right-click the file and select Delete, or select it and click the Delete icon in the toolbar. Confirm the deletion if prompted.
Remove the File via Plesk File Manager
- Log in to your Plesk hosting control panel.
- Select your domain from the dashboard.
- Click File Manager.
- Look for a Settings or preferences option and enable Show hidden files if available.
- Navigate to the folder containing your WordPress installation, typically
httpdocsorpublic_html. - Locate the file named
.maintenance. - Select the file and click Delete. Confirm the deletion if prompted.
Remove the File via FTP
- Open your FTP client, such as FileZilla or Cyberduck.
- Connect to your server using your FTP username, password, and host details provided by your host.
- Navigate to the WordPress root directory.
- Force the client to show hidden files. In FileZilla, go to Server > Force showing hidden files.
- Right-click
.maintenanceand select Delete. - Disconnect from the server.
Check File Permissions After Deletion
After removing the .maintenance file, verify that your file permissions are correct. Incorrect permissions can prevent your site from loading or block access to the dashboard.
- Files: should be set to
644 - Folders: should be set to
755
In cPanel File Manager, right-click a file or folder and select Change Permissions to view or update these values.
Verify Your Site and Dashboard
- Open your website in a browser and confirm the homepage loads without a maintenance message.
- Add
/wp-adminto your domain and log in to the WordPress dashboard. - Go to Dashboard > Updates.
- Check whether WordPress core, themes, or plugins require updates.
- If updates are pending, run them one at a time and wait for each to finish before starting the next.
Avoid triggering multiple updates simultaneously. Running several plugin or theme updates at once increases the chance of a timeout and can return your site to maintenance mode.
Troubleshooting
Site Still Shows Maintenance Mode but .maintenance File Is Not Found
- Clear your browser cache and try again, or open the site in an incognito or private browsing window.
- Check for a
.maintenancefile in subdirectories, especially if WordPress is installed in a subfolder rather than the root. - Check whether your theme or a maintenance plugin has created a
maintenance.phpfile in thewp-contentfolder. - Check whether your hosting provider has applied server-level maintenance. Contact your host if you suspect this is the case.
- Confirm you deleted
.maintenancefrom the correct WordPress root folder, especially if you manage multiple sites on one account.
WordPress Dashboard Is Unavailable
- Confirm your domain and hosting are active and not expired.
- Check whether other sites on the same hosting account are loading. If none are working, there may be a wider hosting issue.
- Rename your
wp-content/pluginsfolder temporarily toplugins_oldto rule out a plugin conflict, then try logging in again.
Updates Keep Failing
- Ensure your hosting account meets the current WordPress requirements for PHP version and memory limit.
- Update plugins and themes individually rather than in bulk.
- Create a full backup of your site and database before attempting further updates.
If you are unable to remove the maintenance file or your site remains offline after following these steps, Open a Ticket and our Brisbane support team will investigate further.
Still Having Issues?
💻 Open a Ticket