Title: wp icon
Published: October 11, 2026
Last modified: October 13, 2026

---

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

Manages registered SVG icons.

## In this article

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

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

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

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

>  **Note:** This command is not part of a stable WP-CLI release yet. To use it 
> now, [switch to the nightly build](https://make.wordpress.org/cli/handbook/guides/installing/#updating-wp-cli)
> with `wp cli update --nightly`. If you installed the command as a separate package,
> updating that package may be enough.

 Icons are registered in code with `wp_register_icon()` by WordPress core, themes,
and plugins, and always belong to an icon collection. Because they only exist for
the duration of a request, they cannot be created or deleted from the command line.
Icon names are namespaced with the slug of the collection they belong to, in the
form `collection/icon-name`.

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

    ```
    # List all registered icons
    $ wp icon list
    +-----------------+------------+------------+
    | name            | label      | collection |
    +-----------------+------------+------------+
    | core/arrow-down | Arrow Down | core       |
    | core/plus       | Plus       | core       |
    +-----------------+------------+------------+

    # Get details about a single icon
    $ wp icon get core/plus --fields=name,label,collection
    +------------+-----------+
    | Field      | Value     |
    +------------+-----------+
    | name       | core/plus |
    | label      | Plus      |
    | collection | core      |
    +------------+-----------+

    # Render an icon at a given size, ready to be embedded in a template
    $ wp icon render core/plus --size=48 --label="Add item" > plus.svg
    ```

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

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

Manages icon collections.

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

Gets details about a registered icon.

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

Checks if an icon is registered.

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

Lists registered icons.

  | 
| [wp icon render](https://developer.wordpress.org/cli/commands/icon/render/) |

Renders the SVG markup of a registered icon.

  |

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