See what to do when your WordPress site breaks because of some plugin. WordPress plugin troubleshooting and figuring out what to do when your site breaks aren’t things general WordPress users want to deal with, but they’re inevitable when you use the platform regularly.
What To Do When Your WordPress Site Breaks?
Some WordPress plugins are coded poorly, to begin with, which can create problems as soon as you install them, causing site breaks. Other plugins aren’t coded poorly until the developer releases an update, which is why you’ll sometimes experience issues after performing an update.
Whatever the case, you installed a new plugin or updated a current one, and your site isn’t functioning correctly. Let’s go through the process of correcting this issue step-by-step.
If you know which WordPress plugin the culprit is
If you know which WordPress plugin is causing the issue, your troubleshooting job just got a heck of a lot easier. All you likely need to do is deactivate the plugin.
How can you determine which plugin is causing the issue without troubleshooting? There are a few different ways you can tell.
- You installed a single plugin and experienced issues with your site immediately or soon.
- You updated a single plugin and experienced issues with your site immediately after.
- An error message tells you exactly which file is causing the issue, and it’s a plugin file.
- For example, if an error occurs with the WP Super Cache plugin, the message might contain this text: /public_html/wp-content/plugins/wp-super-cache/wp-cache.php. Working backward from that bit of text tells me the issue is with the wp-cache.php file in the WP Super Cache plugin folder. The bottom line, the WP Super Cache plugin is causing the problem.
This error message may be written somewhere on the site or the backend of WordPress. You can also use Query Monitor to discover PHP warnings from plugins.
Install and activate the plugin on your site if you don’t know which plugin is causing an issue. To fix the WordPress site when it breaks.
A “Warnings” selection appears in the drop-down menu for this plugin whenever there’s a PHP error.
This will tell you exactly where the errors are coming from and will tell you exactly which plugin is causing the error, if applicable.
If you can access your site
In the case that you can access the WordPress admin area of your site, follow these steps:
- Go to the Plugins page.
- Click the Deactivate link associated with the plugin causing the issue.
- Check your site.
- If the issue is gone, the plugin is the culprit, and fix the WordPress site when it breaks..
- If the issue persists, follow the steps in the If You Don’t Know Which Plugin is the Culprit section.
If you can’t access your site
Some plugins may cause so many issues with your site that you aren’t even able to access them. This may be due to an error message that displays instead of your login page, or the infamous white screen of death may cause it. Whatever the case, you are unable to access your site as you usually would.
You can probably resolve this issue quickly if you’re a developer or an experienced WordPress user. However, if you’re a blogger or a business owner that runs their site, you’re likely running around like a chicken with its head cut off at this point, but don’t panic. There is a way to deactivate plugins without needing to access the backend of WordPress.
If your host uses cPanel, follow these steps:
- Log into cPanel.
- Click File Manager under Files.
- Select Web Root (public_html/www) as a directory, and click Go.
- Double-click the wp-content folder to open it.
- Double-click the plugins folder to open it to fix the WordPress site when it breaks.
- Single-click the folder of the plugin, causing the issue of selecting it.
- Click the Rename button at the top of the page.
- Rename the folder to anything you want. I simply prefer to add a “z” at the end of the name to quicken the process. Click Rename File once you’re done.
Renaming the plugin folder deactivates that plugin. Check your site. Similar to the steps outlined earlier, if the issue is gone, it was caused by that plugin. If it persists, the culprit is elsewhere.
If your host doesn’t use cPanel or you can’t access cPanel, follow these steps:
First of all, not all hosts use cPanel. Hosts like DreamHost and Media Temple use their control panels, so you’ll likely need to follow steps similar to the ones outlined above to use their control panel’s file manager. If you can’t figure it out, use the steps below.
We’ll learn how to access your site via FTP, specifically with FileZilla.
- Download and install FileZilla. Use this link to access the download page.
- Run FileZilla.
- Go to File → Site Manager → New Site.
- Name the site something appropriate, such as your site name.
- Enter these details to fix the WordPress site when it breaks.:
- Host: com
- Port: Leave blank.
- Protocol: FTP – File Transfer Protocol
- Encryption: Only use plain FTP (insecure)
- Login Type: Normal
Use your username and password to access your host’s control panel. For example, if your host uses cPanel, use the username and password you use to log into cPanel.
Lastly, click the Transfer Settings tab, select Limit Number of Simultaneous Connections, and set the Maximum Number of Connections to 8.
Click Connect, and follow these steps:
- There are four cells in FileZilla. Focus on the bottom-left cell.
- Double-click public_html to open your site’s root directory.
- Double-click the wp-content folder to open it.
- Double-click the plugins folder to open it.
- Right-click or Control+Click the folder of the plugin causing the issue, and click Rename.
- Rename the plugin to anything you want. I’m simply going to change it to “z.”
This deactivates the plugin on your site. Check your site. If everything seems to be running smoothly, the plugin was indeed the culprit. Skip to the What Are My Options? Section to see what you can do.
If you don’t know which plugin is the culprit, fix the WordPress site when it breaks.
Things start getting a little more complicated, but it’s still not as scary as you think. If you don’t know which plugin is the culprit, but you know that a plugin is to blame, all you need to do is deactivate all of your plugins and activate them one by one until you find the one that’s causing the issue.
Again, if you don’t know which plugin is causing an issue, use the Query Monitor plugin mentioned earlier to see if any of your plugins emit PHP errors.
When you can access your site
Your job is even easier if you can access your site. Follow these steps:
- Go to the Plugins page.
- Tick the checkbox at the top of the plugin list to select all plugins.
- Click Bulk Actions, and select Deactivate.
- Click Apply.
- This should deactivate all of the plugins on your site. Check to see if it’s indeed fixed. If it is, a plugin is at fault. Follow the rest of the steps if that’s the case. If there’s still an issue, the culprit is elsewhere, likely a corrupted theme or WordPress core file.
- Activate the first plugin on the list.
- Check your site to see if it breaks. If it does, the plugin you activated is the culprit. Continue if all is well.
- Repeat steps 6 and 7 until you find the plugin causing the issue.
In the case you can’t access your site
If you followed along with the If You Know Which Plugin is the Culprit section, you know we used cPanel and FileZilla to access our site’s file system. We’re going to do the same here.
If your host uses cPanel, follow these steps:
- Firstly, log into cPanel.
- Secondly, click File Manager under Files.
- Select Web Root (public_html/www) as a directory, and click Go.
- Double-click the wp-content folder to open it.
- Single-click the plugins folder to select it.
- Click Rename at the top of the page.
- Finally, rename the folder to anything you want. I’m going to add a “z” to the end. Click Rename Fileonce you’re done.
This deactivates all of the plugins on your site. Check to see if all is well. If so, the issue was caused by a faulty plugin. Log into the WordPress admin area, and activate each plugin. Check your site after each activation. If it breaks, the last plugin you activated is causing the issue.
So, deactivating all of your plugins did not fix your site. You likely have a corrupted theme or WordPress core file.
If your host doesn’t use cPanel or you can’t access it, follow these steps:
- Firstly, Download and install FileZilla. Use this link to access the download page.
- Secondly, Run FileZilla.
- Go to File → Site Manager → New Site.
- Name the site something appropriate, such as your site name.
- Finally, Enter these details:
- Host:com
- Port: Leave blank.
- Protocol: FTP – File Transfer Protocol
- Encryption: Only use plain FTP (insecure)
- Logon Type: Normal
Use your username and password to access your host’s control panel to fix the WordPress site when it breaks. For example, if your host uses cPanel, use the username and password you use to log into cPanel.
Lastly, click the Transfer Settings tab, select Limit Number of Simultaneous Connections, and set the Maximum Number of Connections to 8.
Click Connect, and follow these steps:
- Firstly, there are four cells in FileZilla. Focus on the bottom-left cell.
- Secondly, double-click public_html to open your site’s root directory.
- Double-click the wp-content folder to open it.
- Right-click or Control+click the plugins folder, and select Rename.
- Rename the plugins folder to anything you want, such as “plugins-old.”
- Check your site to see if the issue is still there. If it isn’t, the culprit is indeed a plugin. Continue the remaining steps. If it is, you’re experiencing a different issue, such as a corrupted theme or WordPress core file.
- Log into the WordPress admin area of your site.
- Go to the Plugins page.
- Activate the first plugin on the list.
- Check your site to see if it breaks. If it does, the plugin you activated is at fault. Continue if it doesn’t.
- Repeat steps 9 and 10 until you find the plugin at fault.
If you found a faulty plugin, continue to the What Are My Options? Section to learn how to fix it.
What are my options To fix the WordPress site when it breaks?
Okay, so you found a faulty plugin. What’s next? Well, there are several different ways you can resolve this issue:
- Firstly, contact the developer
- Secondly, get help from the community
- Finally, replace the plugin
Option #1 – Contact the Developer
Some plugin causes a Site break it’s expected if they are coded poorly or conflicts with a theme, another plugin, or WordPress itself. Contact the developer if you went through this tutorial and found precisely which plugin is causing the issue.
If you downloaded the plugin from the WordPress repository, create a new thread in the Support section. First, you need to create a new account at WordPress.org and log into it.
Head to the plugin page you need help with, and click Support.
Scroll to the bottom to post a new topic telling the developer precisely what issue you’re having. Don’t simply say, “this plugin broke my site.” Explain exactly how it’s breaking your site, and explain the steps you went through to figure out this is indeed the plugin breaking your site. Link to this article if you need to.
Let the developer know what host you’re using, the exact hosting plan you’re on, which theme you’re using and which additional plugins you’re using. Giving them this information upfront cuts back on all of the back-and-forth posts you and the developer will need to exchange to troubleshoot the issue.
You’re probably eligible for premium support via the developer’s website if you purchased a premium plugin. Browse the developer’s site to see if there’s a contact or support section. If you bought the plugin on CodeCanyon, use the support forum there.
Option #2 – Get help from the WordPress community To fix the site when it breaks
This one is similar to option one, except you’ll use the general support forum on WordPress.org rather than the individual plugin’s support forum. Use this option if the developer can’t resolve the issue and you need this plugin on your site.
Click Support in the main navigation menu of WordPress.org.
Select the Fixing WordPress section.
Create a new thread in this forum. You’re technically not supposed to post theme and plugin issues here, but explain that you already tried to get support from the developer with no such luck. Explain what the developer tried to do if the developer attempted to fix the issue, you have to fix the WordPress site when it breaks.
Option #3 – Replace the Plugin
This is the last resort. At the end of the day, the plugin’s functionality is what’s important, not the plugin itself. If you cannot resolve the issue, you’re having with the plugin. You need to find a way to replace the functionality it’s adding to your site.
Research similar plugins and see if they fulfill your needs. If you can’t find a suitable replacement and cannot find a way to fix the issue the plugin is having, consider hiring a developer to have them fix it. In addition, create a custom plugin for you to add functionality to your site.
Over to you
When your site breaks, it can be stressful, especially if you can’t access your site to try and rectify the issue.
But with these steps, you’ll be able to narrow down the issue to the same plugin that’s causing the problem. Then you’ll know exactly who to contact to resolve the problem.