wp plugin search

Searches the WordPress.org plugin directory.

$ wp plugin search <search> [--page=<page>] [--per-page=<per-page>] [--field=<field>] [--fields=<fields>] [--format=<format>]

Displays plugins in the WordPress.org plugin directory matching a given search query.



The string to search for.


Optional page to display. --- default: 1 ---


Optional number of results to display. --- default: 10 ---


Prints the value of a single field for each plugin.


Ask for specific fields from the API. Defaults to name,slug,author_profile,rating. Acceptable values:

name: Plugin Name slug: Plugin Slug version: Current Version Number author: Plugin Author author_profile: Plugin Author Profile contributors: Plugin Contributors requires: Plugin Minimum Requirements tested: Plugin Tested Up To compatibility: Plugin Compatible With rating: Plugin Rating in Percent and Total Number ratings: Plugin Ratings for each star (1-5) num_ratings: Number of Plugin Ratings homepage: Plugin Author's Homepage description: Plugin's Description short_description: Plugin's Short Description sections: Plugin Readme Sections: description, installation, FAQ, screenshots, other notes, and changelog downloaded: Plugin Download Count last_updated: Plugin's Last Update added: Plugin's Date Added to wordpress.org Repository tags: Plugin's Tags versions: Plugin's Available Versions with D/L Link donate_link: Plugin's Donation Link banners: Plugin's Banner Image Link icons: Plugin's Icon Image Link active_installs: Plugin's Number of Active Installs contributors: Plugin's List of Contributors url: Plugin's URL on wordpress.org


Render output in a particular format. --- default: table options:

  • table
  • csv
  • count
  • json
  • yaml ---


$ wp plugin search dsgnwrks --per-page=20 --format=json
Success: Showing 3 of 3 plugins.
[{"name":"DsgnWrks Instagram Importer Debug","slug":"dsgnwrks-instagram-importer-debug","rating":0},{"name":"DsgnWrks Instagram Importer","slug":"dsgnwrks-instagram-importer","rating":84},{"name":"DsgnWrks Twitter Importer","slug":"dsgnwrks-twitter-importer","rating":80}]

$ wp plugin search dsgnwrks --fields=name,version,slug,rating,num_ratings
Success: Showing 3 of 3 plugins.
| name                              | version | slug                              | rating | num_ratings |
| DsgnWrks Instagram Importer Debug | 0.1.6   | dsgnwrks-instagram-importer-debug | 0      | 0           |
| DsgnWrks Instagram Importer       | 1.3.7   | dsgnwrks-instagram-importer       | 84     | 23          |
| DsgnWrks Twitter Importer         | 1.1.1   | dsgnwrks-twitter-importer         | 80     | 1           |


--path=<path> Path to the WordPress files.

--url=<url> Pretend request came from given URL. In multisite, this argument is how the target site is specified.

--ssh=[<scheme>:][<user>@]<host|container>[:<port>][<path>] Perform operation against a remote server over SSH (or a container using scheme of "docker", "docker-compose", "vagrant").

--http=<http> Perform operation against a remote WordPress installation over HTTP.

--user=<id|login|email> Set the WordPress user.

--skip-plugins[=<plugins>] Skip loading all plugins, or a comma-separated list of plugins. Note: mu-plugins are still loaded.

--skip-themes[=<themes>] Skip loading all themes, or a comma-separated list of themes.

--skip-packages Skip loading all installed packages.

--require=<path> Load PHP file before running the command (may be used more than once).

--[no-]color Whether to colorize the output.

--debug[=<group>] Show all PHP errors and add verbosity to WP-CLI output. Built-in groups include: bootstrap, commandfactory, and help.

--prompt[=<assoc>] Prompt the user to enter values for all command arguments, or a subset specified as comma-separated values.

--quiet Suppress informational messages.

Related commands

Activates one or more plugins.

Deactivates one or more plugins.

Deletes plugin files without deactivating or uninstalling.

Gets details about an installed plugin.

Installs one or more plugins.

Checks if a given plugin is active.

Checks if a given plugin is installed.

Gets a list of plugins.

Gets the path to a plugin or to the plugin directory.

Searches the WordPress.org plugin directory.

Reveals the status of one or all plugins.

Toggles a plugin's activation state.

Uninstalls one or more plugins.

Updates one or more plugins.

Verifies plugin files against WordPress.org's checksums.