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.

OPTIONS

<search>

The string to search for.

[--page=<page>]

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

[--per-page=<per-page>]

Optional number of results to display. Defaults to 10.

[--field=<field>]

Prints the value of a single field for each theme.

[--fields=<fields>]

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

[--format=<format>]

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

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

EXAMPLES

$ 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     |
+----------------------+----------------------+--------+

GLOBAL PARAMETERS

--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
wp theme activate

Activates a theme.

wp theme delete

Deletes one or more themes.

wp theme disable

Disables a theme on a WordPress multisite install.

wp theme enable

Enables a theme on a WordPress multisite install.

wp theme get

Gets details about a theme.

wp theme install

Installs one or more themes.

wp theme is-active

Checks if a given theme is active.

wp theme is-installed

Checks if a given theme is installed.

wp theme list

Gets a list of themes.

wp theme mod

Sets, gets, and removes theme mods.

wp theme path

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

wp theme search

Searches the WordPress.org theme directory.

wp theme status

Reveals the status of one or all themes.

wp theme update

Updates one or more themes.