How to Use the WordPress Plugin Troubleshooter

Modified on: Tue, 19 Aug, 2025 at 10:09 AM

The WordPress Plugin Troubleshooter is a simple tool in your dashboard that helps you quickly spot and fix plugin conflicts. It guides you step by step and can bring your site back even if you’re seeing the White Screen of Death. This article shows you what the tool does, when to use it, and the exact steps to get your site running again fast.


TABLE OF CONTENTS


What is WordPress Plugin Troubleshooter?


WordPress Plugin Troubleshooter is a built-in tool within HighLevel’s Hosting Dashboard that automates the process of identifying the faulty plugin causing site issues. It iteratively disables and re-enables active plugins until the culprit is isolated. This intelligent approach minimizes downtime and helps you restore full site functionality even when encountering severe errors.


Key Benefits of WordPress Plugin Troubleshooter


  • Fast diagnosis: Finds the culprit plugin by testing in smart batches.

  • User-friendly: Easy step-by-step interface that speeds up troubleshooting.

  • One-click fix: Instantly deactivate the faulty plugin to restore performance.

  • Crash-proof: Works even during critical errors like the White Screen of Death.

  • Team-ready: Built for agencies, freelancers, and support teams managing client sites.

How To Use the WordPress Plugin Troubleshooter


Follow these steps for a smooth and efficient troubleshooting process:

 

  1. Log in to your sub-account.

  2. Go to SitesWordPress.



  3. On the WordPress website you want to work on, click Manage Website.



  4. In the top-right of the site manager, click the Quick actions dropdown.

  5. Click Troubleshoot site.



  6. In the Find issues panel, click Start the process.



  7. When prompted, select only the plugins that are essential for your site’s core functionality

  8. Click Confirm plugins. The tool begins inspecting plugins.



  9. What you’ll see: A Finding the fix screen in the right panel.

  10. Click Continue when prompted.



  11. If the tool reports “Broken plugins found—We have identified the plugins causing your site to break”, click Deactivate the plugin to resolve the issue.



  12. On the Issues fixed screen (“We have reloaded your site again. Is everything fixed now?”):

    • If the site is working: click Yes, it is fixed (?).

    • If the site is still not working: click Still broken (?) to continue troubleshooting.



  13. If you see “No plugin issues found—We have tested all active plugins and couldn’t identify a specific plugin causing your issue”:

    • Click Return to dashboard to go back, or

    • Click Restart troubleshooting to run the process again (e.g., adjust your “necessary plugins” selection and retest).


Frequently Asked Questions


Q: Can this tool operate on a site that is partially broken?

Yes, it works even if your site is experiencing severe issues such as a White Screen of Death.


Q: Is it possible to prevent certain plugins from being disabled?

Yes, you can mark essential plugins so they remain active during the troubleshooting process.


Q: How does the tool know which plugin is causing the issue?

By iteratively disabling and re-enabling plugins, the system monitors the site's performance until the faulty plugin is isolated.


Q: Who is the WordPress Plugin Troubleshooter designed for?

It is designed for agency users managing client sites, freelancers, small business owners.



Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article