wp theme search

Searches the WordPress.org theme directory.

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

Displays themes in the WordPress.org theme directory matching a given search query.



The string to search for.


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


Optional number of results to display. Defaults to 10.


Prints the value of a single field for each theme.


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

name: Theme Name slug: Theme Slug version: Current Version Number author: Theme Author preview_url: Theme Preview URL screenshot_url: Theme Screenshot URL rating: Theme Rating num_ratings: Number of Theme Ratings homepage: Theme Author's Homepage description: Theme Description url: Theme's URL on wordpress.org


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

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


$ wp theme search photo --per-page=6
Success: Showing 6 of 203 themes.
| name                 | slug                 | rating |
| Photos               | photos               | 100    |
| Infinite Photography | infinite-photography | 100    |
| PhotoBook            | photobook            | 100    |
| BG Photo Frame       | bg-photo-frame       | 0      |
| fPhotography         | fphotography         | 0      |
| Photo Perfect        | photo-perfect        | 98     |


--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 a theme.

Deletes one or more themes.

Disables a theme on a WordPress multisite install.

Enables a theme on a WordPress multisite install.

Gets details about a theme.

Installs one or more themes.

Checks if a given theme is active.

Checks if a given theme is installed.

Gets a list of themes.

Sets, gets, and removes theme mods.

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

Searches the WordPress.org theme directory.

Reveals the status of one or all themes.

Updates one or more themes.