---
schema_version: "1"
id: 1ed88cdfa3338bb8316a887bb2b7b368b257d779859d9e94a93d8765f4f2a450
title: Navigation Item Input
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/uiapi/ui_api_requests_navigation_item_input.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_requests_navigation_item_input.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: b8c294298045d16fd9f199ada0cf6be40d62b455b1527ac1db135f94dd4f0a6d
description: Represents the list of navigation items in the order that you want them to appear in the app.
---
# Navigation Item Input

Represents the list of navigation items in the order that you want them to appear in the app.

Example

PUT /services/data/v68.0/ui-api/apps/06mRM000000U6pOYAS/user-nav-items

{
  "navItems": \[{
    "id": "0QkRM00000058lN0AQ"
  }, {
    "id": "0QkRM00000058lR0AQ",
    "label": "My Top Account"
  }, {
    "pageReference": {
      "type": "standard\_\_objectPage",
      "attributes": {
        "objectApiName": "Dashboard",
        "actionName": "home"
      },
      "state": {}
    }
  }\]
}

Properties

| Name | Type | Description | Required or Optional | Available Version |
| --- | --- | --- | --- | --- |
| id | String | The ID of the navigation item to include. | Required | 47.0 |
| label | String | The updated label for the navigation item in list views and records only. | Optional | 47.0 |
| pageReference | [Page Reference Input](https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_requests_page_reference_input.htm "To add a navigation item, include a pageReference. A pageReference is a JSON object that describes the navigation item’s page type, its attributes, and the state of the page.") | The page reference of the navigation item to add to the list. You can add one page reference per request. | Optional | 47.0 |

#### See Also

- [Get Personalized Navigation Items](https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_resources_apps_user_nav_items.htm "Get a user’s personalized navigation items (tabs).")
- [Update Personalized Navigation Items](https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_resources_apps_update_nav_items.htm "Updates the order of a user’s personalized navigation items (tabs) and adds a navigation item to the list in the order specified.")