Title: Plugin Detective &#8211; Troubleshooting Conflicts
Author: NSquared
Published: <strong>May 12, 2018</strong>
Last modified: December 9, 2025

---

Search plugins

![](https://ps.w.org/plugin-detective/assets/banner-772x250.png?rev=2865909)

![](https://ps.w.org/plugin-detective/assets/icon.svg?rev=2865909)

# Plugin Detective – Troubleshooting Conflicts

 By [NSquared](https://profiles.wordpress.org/croixhaug/)

[Download](https://downloads.wordpress.org/plugin/plugin-detective.1.2.29.zip)

 * [Details](https://pirate.wordpress.org/plugins/plugin-detective/#description)
 * [Reviews](https://pirate.wordpress.org/plugins/plugin-detective/#reviews)
 *  [Installation](https://pirate.wordpress.org/plugins/plugin-detective/#installation)
 * [Development](https://pirate.wordpress.org/plugins/plugin-detective/#developers)

 [Support](https://wordpress.org/support/plugin/plugin-detective/)

## Description

**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!

Plugin Detective is your best friend when you need to:
 – Troubleshoot WordPress
plugin conflicts – Remove stuck .maintenance files – Recover your site from fatal
errors caused by plugins

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 reactivate them one by one, checking your site for the
problem after each reactivation.

Ugh.

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

#### Find Plugin Conflicts with Detective Otto Bot

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

 1. Open a case and tell Detective Otto where you’re seeing the problem. If your site
    requires any plugins to run correctly, tell Otto about those, too.
 2. Then, Otto will interrogate the suspects and track clues, checking in with you 
    from time to time.
 3. All you need to do is answer “Yes, it’s fixed” or “No, it’s still broken” each 
    time. Otto will do the rest and find the culprit in minutes.

Best of all – Plugin Detective can work even if you’re seeing the White Screen of
Death on your site or if all you can see are PHP errors. Please have a look at 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.

#### Remove Stuck .Maintenance File or Scheduled Maintenance

Have you gotten stuck in maintenance mode on WordPress? The dreaded “Briefly unavailable
for scheduled maintenance. Check back in a minute” message haunts you; the minute
never ends!

With Plugin Detective installed you can quickly get out of these situations without
the hassle of deleting files via your host or FTP. Just tack on this slug to the
end of your website URL:

    ```
    /wp-content/plugins/plugin-detective/troubleshoot/?restore=1
    ```

So that your URL looks like this:

    ```
    https://yoursite.com/wp-content/plugins/plugin-detective/troubleshoot/?restore=1
    ```

This will prompt you to log in and automatically remove that stuck maintenance file
for you.

#### Who Can Use This Troubleshooting Tool?

Plugin Detective is a tool that requires no coding experience or technical knowledge
to use. For that reason, Plugin Detective is the ideal troubleshooting and conflict-
checking tool for:

 * Any WordPress website owner
 * Developers and technical support engineers
 * Plugin and theme owners and their support teams

#### Debug Tool Features

 * Strategically activate and deactivate plugins on your site to help you find the
   plugin causing trouble
 * Open Plugin Detective for troubleshooting on any page on your site – both in 
   the backend and the frontend!
 * Choose any subset of your active plugins as the baseline for your testing

#### Loved by Plugin Support Teams

The [Simply Schedule Appointments](https://simplyscheduleappointments.com/guides/plugin-detective-for-plugin-conflicts/)
and [Draw Attention](https://wpdrawattention.com/guides/plugin-detective-for-finding-conflicts/)
support teams love to share this conflict-checking tool with their customers.
 Plugin
Detective makes it easy for their clients to debug performance issues and figure
out plugin conflicts in a jiffy!

### 1.2.14 – 2023-06-10

#### Features and Improvements

 * Fix PHP 8.2 compatibility

### 1.2.13 – 2023-05-25

#### Features and Improvements

 * Update required WP version to 6.1

### 1.2.12 – 2023-05-25

#### Features and Improvements

 * Update required WP version to 6.1

### 1.2.11 – 2023-04-27

#### Features and Improvements

PR:#25 – Compatibility with WordPress 6.2

### 1.2.10 – 2023-04-11

#### Fixes

PR:#19 – Prevent fatal error on WP versions where WP_Textdomain_Registry doesn…

#### Features and Improvements

### 1.2.9 – 2023-03-28

#### Fixes

#### Features and Improvements

### 1.2.8 – 2023-03-28

#### Fixes

#### Features and Improvements

### 1.2.7 – 2023-03-28

#### Fixes

#### Features and Improvements

### 1.2.6 – 2023-02-24

 * no changes

### 1.2.3

 * Fixed for WP 6.1 compatibility

### 1.2.1

 * Fixed for WP 5.9 compatibility

### 1.1.8

 * Fixed for WP 5.8 compatibility

### 1.1.8

For older changelog entries, please see the [additional changelog.txt file](https://plugins.svn.wordpress.org/plugin-detective/trunk/CHANGELOG.md)
delivered with the plugin.

## Screenshots

 * [[
 * 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

## Installation

#### 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.

## FAQ

### 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 see errors or a white screen. Can I still use Plugin Detective to troubleshoot what’s gone wrong?

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

Once Plugin Detective is installed, head to `yoursite.com/wp-content/plugins/plugin-
detective/troubleshoot`. You’ll be asked to log in with your WordPress username 
and password 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 with another clue that he can use to narrow down
the list of plugins to find the one 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?

Otto was likely interrogating a group of suspects at the time. The clue that the
problem was fixed only narrows it down to one suspect in that group. Give Otto a
couple more rounds of interrogation, and he’ll find the exact plugin 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 run the whole network or just look
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 (team@nsquared.io) 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?)

## Reviews

![](https://secure.gravatar.com/avatar/c03eea0832a1b9f262d25a57d7763a06debc976bfa03e7537a3ca8d6dd646fcf?
s=60&d=retro&r=g)

### 󠀁[Super handy for WordPress Plugin Conflicts Troubleshooting](https://wordpress.org/support/topic/super-handy-for-wordpress-plugin-conflicts-troubleshooting/)󠁿

 [usman738](https://profiles.wordpress.org/usman738/) November 14, 2025

This plugin makes finding plugin conflicts super easy and quick. I’ve used it several
times to troubleshoot issues on client sites, and it worked great every time. It’s
a huge time-saver, letting you avoid the hassle of deactivating and checking plugins
one by one!

![](https://secure.gravatar.com/avatar/7b3097fb875f3dac357fe41aa931e37ac2e34d7de4c65516a33e15f167c19086?
s=60&d=retro&r=g)

### 󠀁[Instantly crashed my site](https://wordpress.org/support/topic/instantly-crashed-my-site-2/)󠁿

 [accomplishtrain](https://profiles.wordpress.org/accomplishtrain/) April 21, 2025

Critical error. Had to roll back site to uninstall.

![](https://secure.gravatar.com/avatar/847c1f44e4ab475d9e9856df6ecd10fc510d484c1f1f307345f5e0c28395a0b7?
s=60&d=retro&r=g)

### 󠀁[Te facilita muchísimo el trabajo](https://wordpress.org/support/topic/te-facilita-muchisimo-el-trabajo/)󠁿

 [Eduardo J. Cabaleiro](https://profiles.wordpress.org/ejca/) March 4, 2025

Cuando recibes una web con 80 plugins y de pronto resulta que hay un conflicto entre
algunos de ellos, este plugin te facilita la vida de una forma enorme. A la caja
de herramientas de cabeza. ¡Gracias!

![](https://secure.gravatar.com/avatar/daff4e1f3583d538d863c7bd9f3cbf2294f0c07ce9d910b19e00df7dfad45ab1?
s=60&d=retro&r=g)

### 󠀁[Worthless.](https://wordpress.org/support/topic/worthless-89/)󠁿

 [LB39](https://profiles.wordpress.org/lecb/) November 6, 2024 1 reply

Installed and activated, and i got a 403 error in NGINX. I was able to resolve the
403, but this led to a new issue, “Error establishing a database connection.” I 
spoke with a programmer, who said “this is not something we can fix as its the way
the plugin is written. The database connection IS working properly, so the plugin
is altering the method in some way, which is breaking it.” Seems that I’m not the
only one with this issue. I sure wish Support would respond with a solution.

![](https://secure.gravatar.com/avatar/43456c36812d20bd938fe0b5cb458c53fa91202af44df929addfa41f8277eed3?
s=60&d=retro&r=g)

### 󠀁[Dumped me to a 403 page.](https://wordpress.org/support/topic/dumped-me-to-a-403-page/)󠁿

 [Steve Manes](https://profiles.wordpress.org/walkthedog/) September 28, 2024 1 
reply

I really wanted this to work but unfortunately it just sent me to an Apache “Forbidden”
page. Maybe it has a conflict with Wordfence or Solid Security.

![](https://secure.gravatar.com/avatar/043b8287faad308b64e0c97d664c18a07114d0a70ea8c5eac3dad5a576a359a9?
s=60&d=retro&r=g)

### 󠀁[Greate Plugin](https://wordpress.org/support/topic/greate-plugin-161/)󠁿

 [Nguyễn Quốc Hùng](https://profiles.wordpress.org/ranbac/) July 1, 2024

Simple, fast and effective

 [ Read all 48 reviews ](https://wordpress.org/support/plugin/plugin-detective/reviews/)

## Contributors & Developers

“Plugin Detective – Troubleshooting Conflicts” is open source software. The following
people have contributed to this plugin.

Contributors

 *   [ NSquared ](https://profiles.wordpress.org/croixhaug/)
 *   [ Natalie MacLees ](https://profiles.wordpress.org/nataliemac/)
 *   [ nsquaredteam ](https://profiles.wordpress.org/nsquaredteam/)

“Plugin Detective – Troubleshooting Conflicts” has been translated into 9 locales.
Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/plugin-detective/contributors)
for their contributions.

[Translate “Plugin Detective – Troubleshooting Conflicts” into your language.](https://translate.wordpress.org/projects/wp-plugins/plugin-detective)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/plugin-detective/),
check out the [SVN repository](https://plugins.svn.wordpress.org/plugin-detective/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/plugin-detective/)
by [RSS](https://plugins.trac.wordpress.org/log/plugin-detective/?limit=100&mode=stop_on_copy&format=rss).

## Meta

 *  Version **1.2.29**
 *  Last updated **4 months ago**
 *  Active installations **5,000+**
 *  WordPress version ** 6.1 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 5.3 or higher **
 *  Languages
 * [Dutch](https://nl.wordpress.org/plugins/plugin-detective/), [English (US)](https://wordpress.org/plugins/plugin-detective/),
   [French (France)](https://fr.wordpress.org/plugins/plugin-detective/), [Italian](https://it.wordpress.org/plugins/plugin-detective/),
   [Russian](https://ru.wordpress.org/plugins/plugin-detective/), [Spanish (Chile)](https://cl.wordpress.org/plugins/plugin-detective/),
   [Spanish (Colombia)](https://es-co.wordpress.org/plugins/plugin-detective/), 
   [Spanish (Mexico)](https://es-mx.wordpress.org/plugins/plugin-detective/), [Spanish (Spain)](https://es.wordpress.org/plugins/plugin-detective/),
   and [Spanish (Venezuela)](https://ve.wordpress.org/plugins/plugin-detective/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/plugin-detective)
 * Tags
 * [administration](https://pirate.wordpress.org/plugins/tags/administration/)[conflicts](https://pirate.wordpress.org/plugins/tags/conflicts/)
   [debug](https://pirate.wordpress.org/plugins/tags/debug/)[support](https://pirate.wordpress.org/plugins/tags/support/)
   [troubleshoot](https://pirate.wordpress.org/plugins/tags/troubleshoot/)
 *  [Advanced View](https://pirate.wordpress.org/plugins/plugin-detective/advanced/)

## Ratings

 4 out of 5 stars.

 *  [  34 5-star reviews     ](https://wordpress.org/support/plugin/plugin-detective/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/plugin-detective/reviews/?filter=4)
 *  [  2 3-star reviews     ](https://wordpress.org/support/plugin/plugin-detective/reviews/?filter=3)
 *  [  2 2-star reviews     ](https://wordpress.org/support/plugin/plugin-detective/reviews/?filter=2)
 *  [  10 1-star reviews     ](https://wordpress.org/support/plugin/plugin-detective/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/plugin-detective/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/plugin-detective/reviews/)

## Contributors

 *   [ NSquared ](https://profiles.wordpress.org/croixhaug/)
 *   [ Natalie MacLees ](https://profiles.wordpress.org/nataliemac/)
 *   [ nsquaredteam ](https://profiles.wordpress.org/nsquaredteam/)

## Support

Issues resolved in last two months:

     0 out of 1

 [View support forum](https://wordpress.org/support/plugin/plugin-detective/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://nsquared.io)