WordPress Site Crash After Plugin Update: How to Restore Access via FTP
Summary
This guide helps you troubleshoot and resolve: WordPress Site Crash After Plugin Update: How to Restore Access via FTP. Follow the steps below to fix the issue.
Common Causes
When a WordPress plugin or theme update causes a site crash, you may be locked out of your dashboard and see a white screen or a critical error message. Because you cannot access the WordPress admin panel to reverse the change, you must use File Transfer Protocol (FTP) to manually deactivate the problematic plugin or theme. This guide walks you through restoring access to your site using an FTP client, with specific context for Australian small business hosting environments such as cPanel.
Quick Fix Steps
- Connect to your server via FTP using your hosting credentials.
- Navigate to the
/wp-content/plugins/directory. - Rename the folder of the plugin you suspect caused the crash.
- Refresh your website to check if access is restored.
- Log into your WordPress dashboard and remove or update the faulty plugin.
Detailed Instructions
1. Gather your FTP credentials
Before you begin, ensure you have the following details from your hosting account. Most Australian hosting providers include these details in cPanel under FTP Accounts:
- FTP Hostname
- FTP Username
- FTP Password
- Port (usually 21 for FTP or 22 for SFTP)
If you do not have your FTP credentials, you can retrieve them via your hosting control panel, such as cPanel, or open a support ticket with your provider.
2. Connect to your server via FTP
- Download and install an FTP client such as FileZilla or WinSCP.
- Open the FTP client and enter your hostname, username, password, and port.
- Use SFTP (port 22) if available for a secure connection.
- Click Quickconnect or Connect to establish the connection.
- Once connected, you will see your local files on the left and your server files on the right.
3. Locate the WordPress installation
Navigate through the directories on the right-hand panel until you find the folder containing your WordPress installation. This is often named public_html, www, or your domain name. Open this folder, then navigate to /wp-content/plugins/.
4. Deactivate the problematic plugin
WordPress automatically deactivates any plugin whose folder name has been changed.
- Right-click the folder of the plugin you believe caused the crash.
- Select Rename.
- Change the name to something like
plugin-name-old(e.g., changecontact-form-7tocontact-form-7-old). - Press
Enterto save the change.
5. Test your site and dashboard
- Open your website in a web browser to see if the front end is loading.
- Navigate to
yourdomain.com.au/wp-adminto attempt to log into your dashboard. - If the site loads, log in using your administrator credentials.
6. Remove or update the faulty plugin
Once you are back in the WordPress admin area:
- Go to Plugins > Installed Plugins.
- Locate the plugin you renamed via FTP. It will likely show as inactive or missing.
- Click Delete to remove the plugin completely.
- If you wish to keep the plugin, download a fresh version from the official WordPress repository and upload it via Plugins > Add New > Upload Plugin.
Diagnosing the Cause
Check error logs and enable WP_DEBUG
If you are unsure which update caused the crash, check your hosting error logs via cPanel or enable debugging in WordPress:
- Connect via FTP and navigate to your WordPress root directory.
- Locate and download the
wp-config.phpfile. - Open the file in a text editor and look for the line
define( 'WP_DEBUG', false );. - Change
falsetotrueso it readsdefine( 'WP_DEBUG', true );. - Save the file and upload it back to the server, overwriting the existing file.
- Refresh your website to view any PHP errors or warnings displayed on screen.
WP_DEBUG back to false once you have finished troubleshooting, as displaying errors on a live site can expose sensitive information.Troubleshooting
What if I don't know which plugin caused the crash?
If you are unsure which update caused the issue, you can deactivate all plugins at once:
- Connect via FTP and navigate to
/wp-content/. - Rename the entire
pluginsfolder toplugins-old. - Refresh your site. If it loads, the issue was definitely plugin-related.
- Rename the folder back to
plugins. - Go into the folder and rename each plugin folder one by one, refreshing your site after each change until the crash returns.
What if the theme caused the crash?
If deactivating plugins does not work, the issue may be your active theme:
- Navigate to
/wp-content/themes/via FTP. - Rename the folder of your active theme.
- WordPress will automatically revert to a default theme, restoring your dashboard access.
File permission issues
If you rename a folder via FTP but the change does not take effect, the issue may be related to file permissions. Ensure that your WordPress directories have the correct permissions (typically 755 for folders and 644 for files) so that the web server can read the updated structure.
What if neither plugin nor theme deactivation restores access?
If renaming plugin and theme folders does not restore access to your dashboard, the issue may be caused by database corruption, a server configuration problem, or a corrupted core WordPress file. In these cases:
- Check your server error logs via cPanel for specific error messages.
- Restore your site from the full backup you created before beginning this process.
- Open a Ticket with our support team for further assistance.
Still Having Issues?
💻 Open a Ticket