How to Use the WordPress Troubleshooter Tool

What Is the WordPress Troubleshooter?

The WordPress Troubleshooter is a built-in tool within your CRM’s hosting dashboard that helps you quickly identify and resolve plugin conflicts on your WordPress sites. It works by systematically disabling and re-enabling active plugins to isolate the one causing issues, such as performance problems or critical errors like the White Screen of Death. This automated process minimizes downtime and restores your site’s functionality efficiently.

Key Benefits of the WordPress Troubleshooter

• Rapid Diagnosis: Tests plugins in smart batches to quickly pinpoint the problematic one.
• User-Friendly Interface: Guides you through each step with clear prompts, making troubleshooting accessible even for non-technical users.
• Instant Resolution: Allows you to deactivate faulty plugins with a single click to restore site performance.
• Crash Resilience: Operates effectively even when your site is experiencing severe errors, ensuring you can recover from critical issues.
• Team-Oriented Design: Ideal for agencies, freelancers, and support teams managing multiple client sites.

How to Use the WordPress Troubleshooter

Follow these steps to troubleshoot your WordPress site:

1. Log in to your sub-account within the CRM.
2. Navigate to Sites → WordPress.
3. Locate the WordPress site you want to troubleshoot and click Manage Website.
4. In the top-right corner of the site manager, click the Quick actions dropdown menu.
5. Select Troubleshoot site from the options.
6. In the Find issues panel, click Start the process.
7. When prompted, select only the plugins essential for your site’s core functionality to ensure they remain active during testing.
8. Click Confirm plugins to proceed.
9. The tool will begin inspecting plugins. You will see a Finding the fix screen in the right panel—click Continue when prompted.
10. If the tool identifies broken plugins, it will display a message and provide an option to Deactivate the plugin. Click this to resolve the issue.
11. On the Issues fixed screen, you will be asked if your site is working:
    • If the site is fixed, click Yes, it is fixed.
    • If the site is still broken, click Still broken to continue troubleshooting.
12. If no plugin issues are found, you can click Return to dashboard or Restart troubleshooting to adjust your plugin selection and retest.

Frequently Asked Questions

Can the troubleshooter work on a partially broken site?

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

Can I prevent certain plugins from being disabled?

Yes, you can mark essential plugins during the selection process to keep them active throughout troubleshooting.

How does the tool identify the problematic plugin?

It iteratively disables and re-enables plugins while monitoring site performance, isolating the one causing the issue.

Who is this tool designed for?

It is built for agency users, freelancers, and small business owners managing WordPress sites.