Plugin Detective – Troubleshooting


Plugin Detective helps you troubleshoot issues on your site quickly and easily to find the cause of a problem. Once the culprit is found, the problem plugin can be quickly deactivated. You can even fix your site when it has the white screen of death (fatal error). You’ll want to have Plugin Detective installed, so if your site crashes from a conflict or bad plugin update, you can get it back up and running quickly!

We’ve all been there – something’s broken on your site. You’ve looked around the web for advice about what to do and have stumbled across the typical wisdom – deactivate all your plugins and then re-activate them one-by-one, checking your site for the problem after each reactivation.


Sure, it works. But who has time for that?

Detective Otto Bot walks you through solving your case one step at a time, all from one single screen.

Just open up a case and tell Detective Otto where you’re seeing the problem. If there are any plugins that are required for your site to run correctly, tell Otto about those too.

Then Otto will interrogate the suspects and keep track of clues, checking in with you from time to time. All you need to do is answer “Yes, it’s fixed” or “No, it’s still broken” each time. Otto does the rest and finds the culprit in just minutes.

Best of all – Plugin Detective can work even if you’re just seeing the White Screen of Death on your site or if all you can see are PHP errors. See the FAQ’s for how to access plugin detective and log into WordPress even if you can’t get to your login screen.

Once Otto has identified the culprit, you can quickly deactivate the troublesome plugin and go about your day.


  • Troubleshoot link on the admin bar
  • Welcome screen
  • Seeing the problem on Otto's screen
  • Marking the key witnesses (required plugins)
  • Testing Otto's screen to see if the problem is still there
  • Culprit found! Option to disable the problem plugin


Manual Installation

  1. Upload the entire /plugin-detective directory to the /wp-content/plugins/ directory.
  2. Activate Plugin Detective through the ‘Plugins’ menu in WordPress.

Preguntas frecuentes

How do I use Plugin Detective?

Install Plugin Detective. Then from the WordPress admin, you’ll find Plugin Detective under the Tools menu.

Alternatively, you’ll find a Troubleshoot link added to your admin bar. Click this link on any page, admin or front end, to troubleshoot an issue you’re seeing on that page.

I just see errors or a white screen. Can I still use Plugin Detective to troubleshoot what’s gone wrong?

As long as you can still access your hosting account, you can install Plugin Detective via FTP. We’ve included instructions for Manual Installation on the Installation tab.

Once Plugin Detective is installed, head to You’ll be asked to log in with your WordPress username and password just to make sure you have the right permissions and then Detective Otto Bot will step you through troubleshooting just like always.

How does Detective Otto figure out which plugin is breaking my site?

Detective Otto learns from you. While interrogating the different suspects, Otto will check in with you to see if the issue is still happening on your site or not. You just need to answer “Fixed” or “Broken” after Otto makes a change.

Each of your answers provides Otto another clue that he is able to use to narrow down the list of plugins to find just the one that’s causing the problem.

What if it’s not easy to see what’s broken?

There’s no time limit on the clues for Otto. Some issues are more complex than others. You can use the embedded screen Otto provides you to step through several steps to see if the issue appears, or you can even open your site in a new window and step through whatever steps it takes to replicate the problem you’re having. Once you have the answer – minutes or even hours later – you can tell Otto either “Yes, it’s fixed” or “No, it’s still broken”.

Is this faster than me troubleshooting my plugins manually?

Yes, it’s much faster. Robots can be really fast at figuring out puzzles like these, and Detective Otto Bot is no exception. Rather than disabling your plugins one-by-one, Otto can disable groups of plugins, and use your answers to quickly narrow the scope of his investigation using binary search (a fancy robot term for saving you time).

I told Detective Otto that the problem was fixed, so why is he still interrogating suspects?

Likely Otto was interrogating a group of suspects at the time. The clue that the problem was fixed only narrows it down to the suspect being in that group. Give Otto a couple more rounds of interrogation, and he’ll find the exact plugin that’s causing your problem.

Does Plugin Detective work on multisite installs?

No, we don’t support multisite yet. We wanted to get Plugin Detective out there for people to use as soon as possible, but there’s a good amount of work to do before it will support multisite. As you may know, multisite can get a bit complicated.

With a single install, it’s easy to determine which plugins are active and manipulate them. With a multisite, there are network-activated plugins and plugins at the site level. And theoretically Plugin Detective could be run the whole network, or just looking at a single site. And there are permission differences between a network admin and a site admin. So it will take some work for us to support all that. We want to see how much interest there is in supporting multisite, and get some feedback from multisite users to understand what would be most useful for them and how they’d use it.

If you’re reading this, you likely want to use Plugin Detective to troubleshoot multisite installs. Please send us an email ( to let us know you’re interested and answer a few questions to help us build this the right way:

Would this just be a tool for you (the network admin)? Or would you want your site admins to be able to run it (and I assume they could only test their site-activated plugins, not disable any that you’ve network-activated?)


WOW What a plugin

Hi Guys,

What a great plugin, works really well and saves a lot of time finding the pesky plugin that is not playing well with the other plugins clients are using on their sites.

Thank you for sharing.


What a time saver!!!!

This plugin worked perfectly to find a javascript console error in the admin area using a page builder. Took me about 5 minutes with the plugin, and about 40 minutes without the plugin (and that’s only because I got lucky and found the problem plugin early on in the deactivating process) I’m actually looking forward to the next time I get an error so I get to use this plugin again! Thanks so much!!!!!


I work for a company that makes software for local development. It’s not uncommon that our customers need help troubleshooting a site they are building. Many times, we’ve had to go the old “tried and true” route of disabling all the plugins and then enabling them a few at a time until we discover the culprit. Plugin Detective goes through a similar process but it’s MUCH faster. I can go through a site with 30+ plugins and determine the offender in less than five minutes.

Faster determination means faster resolution which means happier customer, and that’s what we shoot for. This plugin is a Godsend and everyone who uses WordPress should have it in their arsenal. Great work folks!

Leer todas las 7 reseñas

Colaboradores y desarrolladores

“Plugin Detective – Troubleshooting” es un software de código abierto. Las siguientes personas han colaborado con este plugin.


“Plugin Detective – Troubleshooting” ha sido traducido a 2 idiomas. Gracias a los traductores por sus contribuciones.

Traduce “Plugin Detective – Troubleshooting” a tu idioma.

¿Interesado en el desarrollo?

Revisa el código , echa un vistazo al repositorio SVN , o suscríbete al log de desarrollo por RSS .

Registro de cambios


  • Fixed compatibility with servers running older than PHP5.5


  • Fixed issue on some sites where there are redirects or irregularities with vs


  • Added internationalized strings for future translation


  • Improved support for HTTPS/HTTP issues on some sites


  • Improved support for installs with wp-config.php outside of webroot


  • Added support for sites that use wp-config-local.php
  • Added support for Pantheon hosting config
  • Added support for Pagely (wp-config-hosting.php file)


  • Added warnings for multisite
  • Improved searching for ABSPATH


  • Fixed for sites with wp-content/ in a different location (make sure to define WP_CONTENT_URL and WP_CONTENT_DIR in wp-config.php)
  • Fixed for sites with wp-content/ in a new location
  • Added warning for iThemes Security users who need to adjust settings in order to use Plugin Detective
  • Improved handling of https/http connections and mixed content warnings
  • Added support for wp-content/plugin-detective-config.php (it will load before the Plugin Detective Troubleshooting app, so any required constants can also be defined there)


  • Improved handling of unusual location for wp-config.php file


  • Fixed issue with WordPress installs located in subdirectories
  • Improved handling of unusual formatting in wp-config.php file


  • Fixed issue with “back to WP” button in upper-left corner reactivating the plugin you just deactivated in the final step after the culprit is identified


  • Fixed issue with unusual define() syntax in some wp-config.php files


  • Fixed issue with required plugins not staying active during all tests


  • Fixed issues with older PHP environments


  • First release