A Smarter Way to Debug and Troubleshoot Your WordPress Site

If you’ve ever managed a WordPress site or troubleshooted a WordPress site as part of your job, you know the feeling. A new plugin update, a theme customization, or a simple change suddenly brings your site to a grinding halt. The dreaded white screen of death appears, or worse, a subtle but critical feature stops working, leaving you to figure out what went wrong. This is where the real headache begins the tedious process of deactivating plugins one by one, switching to a default theme, and hoping to find the culprit without breaking your live site.

As a developer and WordPress support engineer, I’ve spent countless hours in this exact situation. The traditional debugging process is not only time-consuming but also risky. Deactivating plugins or changing themes on a live site can disrupt the user experience and lead to lost revenue or traffic. I knew there had to be a better way, a safer, more efficient method to diagnose issues without affecting visitors. That’s why I decided to create the Debugger & Troubleshooter plugin, and today, I’m thrilled to announce that it’s available for free on the WordPress.org repository.

Why I Built This Plugin

Screenshot of Debugger & Troubleshooter Plugin page.

The inspiration for Debugger & Troubleshooter came from my own experiences and frustrations. I needed a tool that could provide a comprehensive overview of a site’s environment and allow me to simulate changes in an isolated session. I envisioned a plugin that would let me:

• See all the critical site information in one place. No more digging through different menus or running separate diagnostics.
• Safely test plugin and theme conflicts. I wanted to be able to deactivate plugins and switch themes only for my browser session, leaving the live site untouched for everyone else.
• Quickly copy and share site data. When seeking help from support forums or colleagues, having a complete snapshot of the site’s configuration is invaluable.
• Easily manage WordPress’s built-in debugging tools. I needed a way to quickly enable and disable WP_DEBUG without having to edit the wp-config.php file.

After weeks of development and refinement, Debugger & Troubleshooter is now a reality, and it’s packed with features designed to make your life easier.

Check and download the plugin here: Debugger & Troubleshooter plugin

What Does It Do?

Debugger & Troubleshooter is more than just a diagnostic tool; it’s a complete debugging suite that empowers you to resolve issues with confidence. Here’s a look at its key features:

1. A Comprehensive Site Information Dashboard

The main Debug & Troubleshooter dashboard showing Site Information.

The first thing you’ll notice is the Site Information dashboard, which gives you a The first thing you’ll notice is the Site Information dashboard, which gives you a complete overview of your WordPress environment. All the essential data is organized into collapsible cards, so you can quickly find what you need without being overwhelmed. The dashboard includes:

• WordPress Information - A detailed list of all your installed themes and plugins, complete with their active or inactive status.
• PHP and Database Information - Key server settings that are crucial for debugging.
• WordPress Constants - A list of important WordPress configuration constants and their values.

And to make sharing this information a breeze, there’s a “Copy to Clipboard” button that gathers all the data in a pre-formatted text block, ready to be pasted into a support ticket or forum post.

2. The Power of Troubleshooting Mode

The Troubleshooting Mode section with theme and plugin selection.

This is where Debugger & Troubleshooter truly shines. With a single click, you can enter Troubleshooting Mode , which creates a safe, isolated session for you to work in. While this mode is active, you can:

• Simulate Plugin Deactivation - Selectively “deactivate” any plugin on your site. The changes will only apply to your browser session, so you can identify conflicts without affecting your visitors.
• Simulate Theme Switching - Instantly preview how your site looks and functions with any installed theme. This is perfect for testing theme compatibility or preparing for a redesign.

When you’re done, simply exit Troubleshooting Mode, and your site will revert to its live state. No cookies to clear, no settings to undo just a seamless and stress-free debugging experience.

3. Effortless WP Debug Management

For developers and advanced users, the native WordPress debug tools are essential. However, enabling them traditionally requires editing your wp-config.php file, which can be cumbersome and risky. We've simplified this process entirely. The WP Debug feature allows you to:

• Toggle WP_DEBUG with a Click - Enable or disable the core WordPress debugging mode directly from the plugin's interface. When active, you'll see PHP notices and warnings on your site, helping you identify code-level issues.
• Control Debug Log and Display - You can choose to have errors saved to a debug.log file in your wp-content directory (WP_DEBUG_LOG) and control whether these errors are displayed on the screen (WP_DEBUG_DISPLAY). This gives you the flexibility to debug in the background without disrupting the user interface.

This feature puts powerful debugging capabilities at your fingertips, saving you time and eliminating the need to access your server's file system for quick checks.

Get It for Free on WordPress.org

I built this plugin to solve a problem that I know many of you face, and I’m excited to share it with the WordPress community. Debugger & Troubleshooter is, and always will be, free. I believe that powerful, intuitive tools should be accessible to everyone, whether you’re a seasoned developer or a first-time site owner.

Ready to take the guesswork out of debugging? You can download Debugger & Troubleshooter from the official WordPress.org plugin repository today.

📥 Download Debugger & Troubleshooter from WordPress.org

I hope this plugin saves you time, reduces your stress, and empowers you to build even better WordPress sites. I’m always open to feedback and suggestions, so please don’t hesitate to reach out and share your thoughts.

Happy debugging!