Title: wp theme
Published: February 5, 2018
Last modified: October 6, 2026

---

# 󠀁[wp theme <command>](https://developer.wordpress.org/cli/commands/theme/)󠁿

Manages themes, including installs, activations, and updates.

## In this article

 * [Examples](https://developer.wordpress.org/cli/commands/theme/?output_format=md#examples)
 * [Subcommands](https://developer.wordpress.org/cli/commands/theme/?output_format=md#subcommands)

[ Back to top](https://developer.wordpress.org/cli/commands/theme/?output_format=md#wp--skip-link--target)

 [ ⌊GitHub⌉ ](https://github.com/wp-cli/extension-command)

 [ View Open Issues (2) ](https://github.com/login?return_to=%2Fissues%3Fq%3Dlabel%3Acommand%3Atheme+sort%3Aupdated-desc+org%3Awp-cli+is%3Aopen)
[ View Closed Issues (77) ](https://github.com/login?return_to=%2Fissues%3Fq%3Dlabel%3Acommand%3Atheme+sort%3Aupdated-desc+org%3Awp-cli+is%3Aclosed)
[Create New Issue](https://github.com/wp-cli/extension-command/issues/new)

See the WordPress [Theme Handbook](https://developer.wordpress.org/themes/) developer
resource for more information on themes.

### 󠀁[Examples](https://developer.wordpress.org/cli/commands/theme/?output_format=md#examples)󠁿

    ```
    # 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 https://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.
    Success: Installed 1 of 1 themes.

    # 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
    ```

### 󠀁[Subcommands](https://developer.wordpress.org/cli/commands/theme/?output_format=md#subcommands)󠁿

| Name | Description | 
| [wp theme activate](https://developer.wordpress.org/cli/commands/theme/activate/) |

Activates a theme.

  | 
| [wp theme auto-updates](https://developer.wordpress.org/cli/commands/theme/auto-updates/) |

Manages theme auto-updates.

  | 
| [wp theme delete](https://developer.wordpress.org/cli/commands/theme/delete/) |

Deletes one or more themes.

  | 
| [wp theme disable](https://developer.wordpress.org/cli/commands/theme/disable/) |

Disables a theme on a WordPress multisite install.

  | 
| [wp theme enable](https://developer.wordpress.org/cli/commands/theme/enable/) |

Enables a theme on a WordPress multisite install.

  | 
| [wp theme get](https://developer.wordpress.org/cli/commands/theme/get/) |

Gets details about a theme.

  | 
| [wp theme install](https://developer.wordpress.org/cli/commands/theme/install/) |

Installs one or more themes.

  | 
| [wp theme is-active](https://developer.wordpress.org/cli/commands/theme/is-active/) |

Checks if a given theme is active.

  | 
| [wp theme is-installed](https://developer.wordpress.org/cli/commands/theme/is-installed/) |

Checks if a given theme is installed.

  | 
| [wp theme list](https://developer.wordpress.org/cli/commands/theme/list/) |

Gets a list of themes.

  | 
| [wp theme mod](https://developer.wordpress.org/cli/commands/theme/mod/) |

Sets, gets, and removes theme mods.

  | 
| [wp theme path](https://developer.wordpress.org/cli/commands/theme/path/) |

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

  | 
| [wp theme search](https://developer.wordpress.org/cli/commands/theme/search/) |

Searches the WordPress.org theme directory.

  | 
| [wp theme status](https://developer.wordpress.org/cli/commands/theme/status/) |

Reveals the status of one or all themes.

  | 
| [wp theme uninstall](https://developer.wordpress.org/cli/commands/theme/uninstall/) |

Deletes one or more themes.

  | 
| [wp theme update](https://developer.wordpress.org/cli/commands/theme/update/) |

Updates one or more themes.

  | 
| [wp theme upgrade](https://developer.wordpress.org/cli/commands/theme/upgrade/) |

Updates one or more themes.

  |

 _Command documentation is regenerated at every release. To add or update an example,
please submit a pull request against the corresponding part of the codebase._