wp theme <command>

Manages themes, including installs, activations, and updates.

$ wp theme <command>


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.

See the WordPress Theme Handbook developer resource for more information on themes.


# Install the latest version of a theme from wordpress.org and activate
$ wp theme install twentysixteen --activate
Installing Twenty Sixteen (1.2)
Downloading install package from http://downloads.wordpress.org/theme/twentysixteen.1.2.zip...
Unpacking the package...
Installing the theme...
Theme installed successfully.
Activating 'twentysixteen'...
Success: Switched to 'Twenty Sixteen' theme.

# Get details of an installed theme
$ wp theme get twentysixteen --fields=name,title,version
| Field   | Value          |
| name    | Twenty Sixteen |
| title   | Twenty Sixteen |
| version | 1.2            |

# Get status of theme
$ wp theme status twentysixteen
Theme twentysixteen details:
     Name: Twenty Sixteen
     Status: Active
     Version: 1.2
     Author: the WordPress team


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