Menu Items

These routes let you retrieve, create, update, and delete classic navigation-menu items.

Available routes (endpoints are described below):

/wp/v2/menu-items
/wp/v2/menu-items/{id}

Controller classes:

• WP_REST_Menu_Items_Controller{}
  • WP_REST_Posts_Controller{}

Resource schema

The schema lists fields returned by the resource. Fields depend on the context and user capabilities.

Field	Context	Description
id	view, edit	Resource field.
title	view, edit	Resource field.
url	view, edit	Resource field.
description	view, edit	Resource field.
parent	view, edit	Resource field.
menus	view, edit	Resource field.
type	view, edit	Resource field.
object	view, edit	Resource field.
object_id	view, edit	Resource field.

/wp/v2/menu-items

An OPTIONS request returns methods, parameters, and the complete schema for the selected route.

$ curl -X OPTIONS -i https://example.com/wp-json/wp/v2/menu-items

Get data

Request type

GET /wp/v2/menu-items

Request parameters

$context(string)

Response context: view, embed, or edit.

$page(integer)

Collection page number.

$per_page(integer)

Number of items per page.

Request example

$ curl https://example.com/wp-json/wp/v2/menu-items

Create, update, and delete

Request type

POST /wp/v2/menu-items
POST /wp/v2/menu-items/{id}
DELETE /wp/v2/menu-items/{id}

Request parameters

$id(string)

Resource field value.

$title(string)

Resource field value.

$url(string)

Resource field value.

$description(string)

Resource field value.

Request example

$ curl -X POST https://example.com/wp-json/wp/v2/menu-items -d status=publish