iandunn/wp-cli-plugin-active-on-sites

A WP-CLI command to list all sites in a Multisite network that have activated a given plugin

v1.0.0 2026-06-04 00:00 UTC

Requires (Dev)

• wp-cli/entity-command: ^2
• wp-cli/extension-command: ^2
• wp-cli/wp-cli-tests: ^4.2

GPL-2.0-or-later

• Ian Dunn

• plugins
• wordpress
• multisite
• wp-cli

README

A WP-CLI command to list all sites in a Multisite network that have activated a given plugin.

Installing

1. Ensure your composer.json has composer/installers and an installer-paths entry for type:wordpress-plugin:

   {
       "require": {
           "composer/installers": "^2.0"
       },
       "extra": {
           "installer-paths": {
               "wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
           }
       }
   }

   Most Composer-managed WordPress projects already have this.

2. Require the package:

   composer require iandunn/wp-cli-plugin-active-on-sites

3. Activate the plugin:

   wp plugin activate wp-cli-plugin-active-on-sites --network

Usage

wp plugin active-on-sites <plugin_slug>

wp plugin active-on-sites --none

See wp help plugin active-on-sites for details specifying fields, output format, etc.

Examples

Find all sites where a specific plugin is active:

> wp plugin active-on-sites eu-cookie-law-widget

Checking each site  100% [==================================================] 0:02 / 0:03

Sites where eu-cookie-law-widget is active:
+---------+----------------------------------------+
| blog_id | url                                    |
+---------+----------------------------------------+
| 320     | http://2014.madrid.wordcamp.test/      |
| 371     | http://2014.paris.wordcamp.test/       |
| 413     | http://2015.london.wordcamp.test/      |
| 464     | http://2015.milano.wordcamp.test/      |
| 522     | http://2016.geneva.wordcamp.test/      |
| 571     | http://2016.belfast.wordcamp.test/     |
| 654     | http://2017.europe.wordcamp.test/      |
+---------+----------------------------------------+

Find all installed plugins that aren't active on any site:

> wp plugin active-on-sites --none

Checking each site  100% [==================================================] 0:02 / 0:03

Plugins not active on any site:
+---------------------------+------------------------------+
| slug                      | name                         |
+---------------------------+------------------------------+
| akismet                   | Akismet Anti-Spam            |
| hello-dolly               | Hello Dolly                  |
+---------------------------+------------------------------+

Local Development

git clone https://github.com/iandunn/wp-cli-plugin-active-on-sites
composer install
composer prepare-tests

composer test           # run all tests
composer test-rerun		# re-run only failed scenarios

composer test -- features/plugin-active-on-sites.feature        # run a single feature file
composer test -- features/plugin-active-on-sites.feature:42		# run a single scenario by line number
composer test -- --tags=@network                                # run only network-activation scenarios

When run inside a LocalWP shell, composer test routes to bin/behat-localwp, which auto-detects the MySQL socket. Outside LocalWP (e.g. CI), it falls back to run-behat-tests.