---
schema_version: "1"
id: 801d40acb51c4ce96d927f78565e6450bdd9f1181eac8092e9d6081b167ce06a
title: MenuItem
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_tooling/tooling_api_objects_menuitem.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_tooling.meta/api_tooling/tooling_api_objects_menuitem.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 40d478f34fad21cbad334a4c70bd129121208c07fa54cc315d45a2850993b0bd
description: Represents a menu item.
---
# MenuItem

Represents a menu item.

This object is available in API version 32.0 and later.

## Supported SOAP Calls

query(), update()

## Supported REST HTTP Methods

GET, POST

## Fields

| Field | Details |
| --- | --- |
| Active | 
Type

boolean

Properties

Defaulted on create, Filter, Group, Sort, Update

Description

Indicates whether the item in the menu is active (true) or not (false).



 |
| AppId | 

Type

string

Properties

Filter, Group, Sort

Description

The ID of the app that this menu item is associated with. Can be an enum (such as Feed or People) or an alphanumeric ID.

Use AppId as the unique ID for the menu item, not Id.



 |
| Color | 

Type

string

Properties

Filter, Group, Nillable, Sort

Description

The color of the menu item that appears in the user interface. This field is described in Web color RGB format, such as 00FF00.



 |
| IconURL | 

Type

url

Properties

Filter, Group, Nillable, Sort

Description

The URL of an icon in the menu item.



 |
| Label | 

Type

string

Properties

Filter, Group, Nillable, Sort

Description

The menu item label that appears in the user interface.



 |
| MenuType | 

Type

picklist

Properties

Filter, Group, Nillable, Restricted picklist, Sort

Description

The type of menu that this menu item belongs to. Valid values are:

- AppSwitcher: the app menu, a drop-down menu that’s displayed at the top of every app page
- Salesforce1: the Salesforce mobile app navigation menu
- NetworkTabs: the Digital Experiences tab set

This field is required for query().



 |
| SortOrder | 

Type

int

Properties

Filter, Group, Nillable, Sort, Update

Description

The SortOrder value determines the order in which a menu item is displayed in the user interface. This field must be an ordinal number greater than 0, and must be unique in the list. Inactive menu items have a value of -1.



 |
| Theme | 

Type

string

Properties

Filter, Group, Nillable, Sort

Description

The associated theme, which must be one of the following values.

- theme2: the Salesforce theme that was used prior to Spring ’10
- theme3: the Salesforce theme that was introduced in Spring ’10
- theme4: the theme that was introduced in Winter ’14 for the mobile touchscreen version of Salesforce
- custom: the theme that’s associated with a custom icon

This field is required for query() for Color and IconURL.



 |

## Usage

MenuItem can be queried and manipulated to change how menu items appear in Salesforce. The following example modifies the Salesforce mobile app navigation menu.

String query = "SELECT AppId, Label, Active, SortOrder FROM MenuItem "
+
     "WHERE MenuType = 'Salesforce'";
SObject\[\] records = sforce.query(query).getRecords();

//Activate all menu items
for (int i = 0; i < records.length; i++) {
   MenuItem item = (MenuItem)records\[i\];
   item.setOrder(i + 1);
   item.setActive(true);
}

sforce.update(records);