Title: wp menu
Published: February 5, 2018
Last modified: April 13, 2026

---

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

Lists, creates, assigns, and deletes the active theme’s navigation menus.

## In this article

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

[ Back to top](https://developer.wordpress.org/cli/commands/menu/?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%3Amenu+sort%3Aupdated-desc+org%3Awp-cli+is%3Aopen)
[ View Closed Issues (24) ](https://github.com/login?return_to=%2Fissues%3Fq%3Dlabel%3Acommand%3Amenu+sort%3Aupdated-desc+org%3Awp-cli+is%3Aclosed)
[Create New Issue](https://github.com/wp-cli/entity-command/issues/new)

See the [Navigation Menus](https://developer.wordpress.org/themes/functionality/navigation-menus/)
reference in the Theme Handbook.

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

    ```
    # Create a new menu
    $ wp menu create "My Menu"
    Success: Created menu 200.

    # List existing menus
    $ wp menu list
    +---------+----------+----------+-----------+-------+
    | term_id | name     | slug     | locations | count |
    +---------+----------+----------+-----------+-------+
    | 200     | My Menu  | my-menu  |           | 0     |
    | 177     | Top Menu | top-menu | primary   | 7     |
    +---------+----------+----------+-----------+-------+

    # Create a new menu link item
    $ wp menu item add-custom my-menu Apple http://apple.com --porcelain
    1922

    # Assign the 'my-menu' menu to the 'primary' location
    $ wp menu location assign my-menu primary
    Success: Assigned location primary to menu my-menu.
    ```

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

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

Creates a new menu.

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

Deletes one or more menus.

  | 
| [wp menu item](https://developer.wordpress.org/cli/commands/menu/item/) |

List, add, and delete items associated with a menu.

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

Gets a list of menus.

  | 
| [wp menu location](https://developer.wordpress.org/cli/commands/menu/location/) |

Assigns, removes, and lists a menu’s locations.

  |

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