Skip to content

menu

Source: undefined

A native Icon to be used for the menu item

Platform-specific:

  • Windows / Linux: Unsupported.

Add: "Add";

Source: undefined

An add item template image.

Advanced: "Advanced";

Source: undefined

Advanced preferences toolbar icon for the preferences window.

Bluetooth: "Bluetooth";

Source: undefined

A Bluetooth template image.

Bookmarks: "Bookmarks";

Source: undefined

Bookmarks image suitable for a template.

Caution: "Caution";

Source: undefined

A caution image.

ColorPanel: "ColorPanel";

Source: undefined

A color panel toolbar icon.

ColumnView: "ColumnView";

Source: undefined

A column view mode template image.

Computer: "Computer";

Source: undefined

A computer icon.

EnterFullScreen: "EnterFullScreen";

Source: undefined

An enter full-screen mode template image.

Everyone: "Everyone";

Source: undefined

Permissions for all users.

ExitFullScreen: "ExitFullScreen";

Source: undefined

An exit full-screen mode template image.

FlowView: "FlowView";

Source: undefined

A cover flow view mode template image.

Folder: "Folder";

Source: undefined

A folder image.

FolderBurnable: "FolderBurnable";

Source: undefined

A burnable folder icon.

FolderSmart: "FolderSmart";

Source: undefined

A smart folder icon.

FollowLinkFreestanding: "FollowLinkFreestanding";

Source: undefined

A link template image.

FontPanel: "FontPanel";

Source: undefined

A font panel toolbar icon.

GoLeft: "GoLeft";

Source: undefined

A go back template image.

GoRight: "GoRight";

Source: undefined

A go forward template image.

Home: "Home";

Source: undefined

Home image suitable for a template.

IChatTheater: "IChatTheater";

Source: undefined

An iChat Theater template image.

IconView: "IconView";

Source: undefined

An icon view mode template image.

Info: "Info";

Source: undefined

An information toolbar icon.

InvalidDataFreestanding: "InvalidDataFreestanding";

Source: undefined

A template image used to denote invalid data.

LeftFacingTriangle: "LeftFacingTriangle";

Source: undefined

A generic left-facing triangle template image.

ListView: "ListView";

Source: undefined

A list view mode template image.

LockLocked: "LockLocked";

Source: undefined

A locked padlock template image.

LockUnlocked: "LockUnlocked";

Source: undefined

An unlocked padlock template image.

MenuMixedState: "MenuMixedState";

Source: undefined

A horizontal dash, for use in menus.

MenuOnState: "MenuOnState";

Source: undefined

A check mark template image, for use in menus.

MobileMe: "MobileMe";

Source: undefined

A MobileMe icon.

MultipleDocuments: "MultipleDocuments";

Source: undefined

A drag image for multiple items.

Network: "Network";

Source: undefined

A network icon.

Path: "Path";

Source: undefined

A path button template image.

PreferencesGeneral: "PreferencesGeneral";

Source: undefined

General preferences toolbar icon for the preferences window.

QuickLook: "QuickLook";

Source: undefined

A Quick Look template image.

Refresh: "Refresh";

Source: undefined

A refresh template image.

RefreshFreestanding: "RefreshFreestanding";

Source: undefined

A refresh template image.

Remove: "Remove";

Source: undefined

A remove item template image.

RevealFreestanding: "RevealFreestanding";

Source: undefined

A reveal contents template image.

RightFacingTriangle: "RightFacingTriangle";

Source: undefined

A generic right-facing triangle template image.

Share: "Share";

Source: undefined

A share view template image.

Slideshow: "Slideshow";

Source: undefined

A slideshow template image.

SmartBadge: "SmartBadge";

Source: undefined

A badge for a smart item.

StatusAvailable: "StatusAvailable";

Source: undefined

Small green indicator, similar to iChat’s available image.

StatusNone: "StatusNone";

Source: undefined

Small clear indicator.

StatusPartiallyAvailable: "StatusPartiallyAvailable";

Source: undefined

Small yellow indicator, similar to iChat’s idle image.

StatusUnavailable: "StatusUnavailable";

Source: undefined

Small red indicator, similar to iChat’s unavailable image.

StopProgress: "StopProgress";

Source: undefined

A stop progress button template image.

StopProgressFreestanding: "StopProgressFreestanding";

Source: undefined

A stop progress template image.

TrashEmpty: "TrashEmpty";

Source: undefined

An image of the empty trash can.

TrashFull: "TrashFull";

Source: undefined

An image of the full trash can.

User: "User";

Source: undefined

Permissions for a single user.

UserAccounts: "UserAccounts";

Source: undefined

User account toolbar icon for the preferences window.

UserGroup: "UserGroup";

Source: undefined

Permissions for a group of users.

UserGuest: "UserGuest";

Source: undefined

Permissions for guests.

Source: undefined

A check menu item inside a Menu or Submenu and usually contains a text and a check mark or a similar toggle that corresponds to a checked and unchecked states.

  • MenuItemBase

get id(): string;

Source: undefined

The id of this item.

string

MenuItemBase.id

get rid(): number;

Source: undefined

number

MenuItemBase.rid

asyncDispose: Promise<void>;

Source: undefined

Promise<void>

MenuItemBase.[asyncDispose]

close(): Promise<void>;

Source: undefined

Destroys and cleans up this resource from memory. You should not call any method on this object anymore and should drop any reference to it.

Promise<void>

MenuItemBase.close

isChecked(): Promise<boolean>;

Source: undefined

Returns whether this check menu item is checked or not.

Promise<boolean>

isEnabled(): Promise<boolean>;

Source: undefined

Returns whether this check menu item is enabled or not.

Promise<boolean>

setAccelerator(accelerator): Promise<void>;

Source: undefined

Sets the accelerator for this check menu item.

Parameter Type
accelerator string | null

Promise<void>

setChecked(checked): Promise<void>;

Source: undefined

Sets whether this check menu item is checked or not.

Parameter Type
checked boolean

Promise<void>

setEnabled(enabled): Promise<void>;

Source: undefined

Sets whether this check menu item is enabled or not.

Parameter Type
enabled boolean

Promise<void>

setText(text): Promise<void>;

Source: undefined

Sets the text for this check menu item.

Parameter Type
text string

Promise<void>

text(): Promise<string>;

Source: undefined

Returns the text of this check menu item.

Promise<string>

static new(opts): Promise<CheckMenuItem>;

Source: undefined

Create a new check menu item.

Parameter Type
opts CheckMenuItemOptions

Promise<CheckMenuItem>


Source: undefined

An icon menu item inside a Menu or Submenu and usually contains an icon and a text.

  • MenuItemBase

get id(): string;

Source: undefined

The id of this item.

string

MenuItemBase.id

get rid(): number;

Source: undefined

number

MenuItemBase.rid

asyncDispose: Promise<void>;

Source: undefined

Promise<void>

MenuItemBase.[asyncDispose]

close(): Promise<void>;

Source: undefined

Destroys and cleans up this resource from memory. You should not call any method on this object anymore and should drop any reference to it.

Promise<void>

MenuItemBase.close

isEnabled(): Promise<boolean>;

Source: undefined

Returns whether this icon menu item is enabled or not.

Promise<boolean>

setAccelerator(accelerator): Promise<void>;

Source: undefined

Sets the accelerator for this icon menu item.

Parameter Type
accelerator string | null

Promise<void>

setEnabled(enabled): Promise<void>;

Source: undefined

Sets whether this icon menu item is enabled or not.

Parameter Type
enabled boolean

Promise<void>

setIcon(icon): Promise<void>;

Source: undefined

Sets an icon for this icon menu item

Parameter Type
icon MenuIcon | null

Promise<void>

setText(text): Promise<void>;

Source: undefined

Sets the text for this icon menu item.

Parameter Type
text string

Promise<void>

text(): Promise<string>;

Source: undefined

Returns the text of this icon menu item.

Promise<string>

static new(opts): Promise<IconMenuItem>;

Source: undefined

Create a new icon menu item.

Parameter Type
opts IconMenuItemOptions

Promise<IconMenuItem>


Source: undefined

A type that is either a menu bar on the window on Windows and Linux or as a global menu in the menubar on macOS.

Platform-specific:

  • macOS: if using Menu for the global menubar, it can only contain Submenus.
  • MenuItemBase

get id(): string;

Source: undefined

The id of this item.

string

MenuItemBase.id

get rid(): number;

Source: undefined

number

MenuItemBase.rid

asyncDispose: Promise<void>;

Source: undefined

Promise<void>

MenuItemBase.[asyncDispose]

append<T>(items): Promise<void>;

Source: undefined

Add a menu item to the end of this menu.

Platform-specific:

Type Parameter
T extends | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | MenuItemOptions | SubmenuOptions | IconMenuItemOptions | PredefinedMenuItemOptions | CheckMenuItemOptions
Parameter Type
items T | T[]

Promise<void>

close(): Promise<void>;

Source: undefined

Destroys and cleans up this resource from memory. You should not call any method on this object anymore and should drop any reference to it.

Promise<void>

MenuItemBase.close

get(id): Promise<
| Submenu
| MenuItem
| PredefinedMenuItem
| CheckMenuItem
| IconMenuItem
| null>;

Source: undefined

Retrieves the menu item matching the given identifier.

Parameter Type
id string

Promise< | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | null>

insert<T>(items, position): Promise<void>;

Source: undefined

Add a menu item to the specified position in this menu.

Platform-specific:

Type Parameter
T extends | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | MenuItemOptions | SubmenuOptions | IconMenuItemOptions | PredefinedMenuItemOptions | CheckMenuItemOptions
Parameter Type
items T | T[]
position number

Promise<void>

items(): Promise<(
| Submenu
| MenuItem
| PredefinedMenuItem
| CheckMenuItem
| IconMenuItem)[]>;

Source: undefined

Returns a list of menu items that has been added to this menu.

Promise<( | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem)[]>

popup(at?, window?): Promise<void>;

Source: undefined

Popup this menu as a context menu on the specified window.

Parameter Type Description
at? | PhysicalPosition | LogicalPosition | Position If a position is provided, it is relative to the window’s top-left corner. If there isn’t one provided, the menu will pop up at the current location of the mouse.
window? Window -

Promise<void>

prepend<T>(items): Promise<void>;

Source: undefined

Add a menu item to the beginning of this menu.

Platform-specific:

Type Parameter
T extends | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | MenuItemOptions | SubmenuOptions | IconMenuItemOptions | PredefinedMenuItemOptions | CheckMenuItemOptions
Parameter Type
items T | T[]

Promise<void>

remove(item): Promise<void>;

Source: undefined

Remove a menu item from this menu.

Parameter Type
item | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem

Promise<void>

removeAt(position): Promise<
| Submenu
| MenuItem
| PredefinedMenuItem
| CheckMenuItem
| IconMenuItem
| null>;

Source: undefined

Remove a menu item from this menu at the specified position.

Parameter Type
position number

Promise< | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | null>

setAsAppMenu(): Promise<Menu | null>;

Source: undefined

Sets the app-wide menu and returns the previous one.

If a window was not created with an explicit menu or had one set explicitly, this menu will be assigned to it.

Promise<Menu | null>

setAsWindowMenu(window?): Promise<Menu | null>;

Source: undefined

Sets the window menu and returns the previous one.

Platform-specific:

  • macOS: Unsupported. The menu on macOS is app-wide and not specific to one window, if you need to set it, use Menu.setAsAppMenu instead.
Parameter Type
window? Window

Promise<Menu | null>

static default(): Promise<Menu>;

Source: undefined

Create a default menu.

Promise<Menu>

static new(opts?): Promise<Menu>;

Source: undefined

Create a new menu.

Parameter Type
opts? MenuOptions

Promise<Menu>


Source: undefined

A menu item inside a Menu or Submenu and contains only text.

  • MenuItemBase

get id(): string;

Source: undefined

The id of this item.

string

MenuItemBase.id

get rid(): number;

Source: undefined

number

MenuItemBase.rid

asyncDispose: Promise<void>;

Source: undefined

Promise<void>

MenuItemBase.[asyncDispose]

close(): Promise<void>;

Source: undefined

Destroys and cleans up this resource from memory. You should not call any method on this object anymore and should drop any reference to it.

Promise<void>

MenuItemBase.close

isEnabled(): Promise<boolean>;

Source: undefined

Returns whether this menu item is enabled or not.

Promise<boolean>

setAccelerator(accelerator): Promise<void>;

Source: undefined

Sets the accelerator for this menu item.

Parameter Type
accelerator string | null

Promise<void>

setEnabled(enabled): Promise<void>;

Source: undefined

Sets whether this menu item is enabled or not.

Parameter Type
enabled boolean

Promise<void>

setText(text): Promise<void>;

Source: undefined

Sets the text for this menu item.

Parameter Type
text string

Promise<void>

text(): Promise<string>;

Source: undefined

Returns the text of this menu item.

Promise<string>

static new(opts): Promise<MenuItem>;

Source: undefined

Create a new menu item.

Parameter Type
opts MenuItemOptions

Promise<MenuItem>


Source: undefined

A predefined (native) menu item which has a predefined behavior by the OS or by tauri.

  • MenuItemBase

get id(): string;

Source: undefined

The id of this item.

string

MenuItemBase.id

get rid(): number;

Source: undefined

number

MenuItemBase.rid

asyncDispose: Promise<void>;

Source: undefined

Promise<void>

MenuItemBase.[asyncDispose]

close(): Promise<void>;

Source: undefined

Destroys and cleans up this resource from memory. You should not call any method on this object anymore and should drop any reference to it.

Promise<void>

MenuItemBase.close

setText(text): Promise<void>;

Source: undefined

Sets the text for this predefined menu item.

Parameter Type
text string

Promise<void>

text(): Promise<string>;

Source: undefined

Returns the text of this predefined menu item.

Promise<string>

static new(opts?): Promise<PredefinedMenuItem>;

Source: undefined

Create a new predefined menu item.

Parameter Type
opts? PredefinedMenuItemOptions

Promise<PredefinedMenuItem>


Source: undefined

A type that is a submenu inside a Menu or Submenu.

  • MenuItemBase

get id(): string;

Source: undefined

The id of this item.

string

MenuItemBase.id

get rid(): number;

Source: undefined

number

MenuItemBase.rid

asyncDispose: Promise<void>;

Source: undefined

Promise<void>

MenuItemBase.[asyncDispose]

append<T>(items): Promise<void>;

Source: undefined

Add a menu item to the end of this submenu.

Platform-specific:

Type Parameter
T extends | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | MenuItemOptions | SubmenuOptions | IconMenuItemOptions | PredefinedMenuItemOptions | CheckMenuItemOptions
Parameter Type
items T | T[]

Promise<void>

close(): Promise<void>;

Source: undefined

Destroys and cleans up this resource from memory. You should not call any method on this object anymore and should drop any reference to it.

Promise<void>

MenuItemBase.close

get(id): Promise<
| Submenu
| MenuItem
| PredefinedMenuItem
| CheckMenuItem
| IconMenuItem
| null>;

Source: undefined

Retrieves the menu item matching the given identifier.

Parameter Type
id string

Promise< | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | null>

insert<T>(items, position): Promise<void>;

Source: undefined

Add a menu item to the specified position in this submenu.

Platform-specific:

Type Parameter
T extends | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | MenuItemOptions | SubmenuOptions | IconMenuItemOptions | PredefinedMenuItemOptions | CheckMenuItemOptions
Parameter Type
items T | T[]
position number

Promise<void>

isEnabled(): Promise<boolean>;

Source: undefined

Returns whether this submenu is enabled or not.

Promise<boolean>

items(): Promise<(
| Submenu
| MenuItem
| PredefinedMenuItem
| CheckMenuItem
| IconMenuItem)[]>;

Source: undefined

Returns a list of menu items that has been added to this submenu.

Promise<( | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem)[]>

popup(at?, window?): Promise<void>;

Source: undefined

Popup this submenu as a context menu on the specified window.

If the position, is provided, it is relative to the window’s top-left corner.

Parameter Type
at? | PhysicalPosition | LogicalPosition
window? Window

Promise<void>

prepend<T>(items): Promise<void>;

Source: undefined

Add a menu item to the beginning of this submenu.

Platform-specific:

Type Parameter
T extends | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | MenuItemOptions | SubmenuOptions | IconMenuItemOptions | PredefinedMenuItemOptions | CheckMenuItemOptions
Parameter Type
items T | T[]

Promise<void>

remove(item): Promise<void>;

Source: undefined

Remove a menu item from this submenu.

Parameter Type
item | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem

Promise<void>

removeAt(position): Promise<
| Submenu
| MenuItem
| PredefinedMenuItem
| CheckMenuItem
| IconMenuItem
| null>;

Source: undefined

Remove a menu item from this submenu at the specified position.

Parameter Type
position number

Promise< | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | null>

setAsHelpMenuForNSApp(): Promise<void>;

Source: undefined

Set this submenu as the Help menu for the application on macOS.

This will cause macOS to automatically add a search box to the menu.

If no menu is set as the Help menu, macOS will automatically use any menu which has a title matching the localized word “Help”.

Platform-specific:

  • Windows / Linux: Unsupported.

Promise<void>

setAsWindowsMenuForNSApp(): Promise<void>;

Source: undefined

Set this submenu as the Window menu for the application on macOS.

This will cause macOS to automatically add window-switching items and certain other items to the menu.

Platform-specific:

  • Windows / Linux: Unsupported.

Promise<void>

setEnabled(enabled): Promise<void>;

Source: undefined

Sets whether this submenu is enabled or not.

Parameter Type
enabled boolean

Promise<void>

setIcon(icon): Promise<void>;

Source: undefined

Sets an icon for this submenu

Parameter Type
icon MenuIcon | null

Promise<void>

setText(text): Promise<void>;

Source: undefined

Sets the text for this submenu.

Parameter Type
text string

Promise<void>

text(): Promise<string>;

Source: undefined

Returns the text of this submenu.

Promise<string>

static new(opts): Promise<Submenu>;

Source: undefined

Create a new submenu.

Parameter Type
opts SubmenuOptions

Promise<Submenu>

Source: undefined

A metadata for the about predefined menu item.

Property Type Description Defined in
authors? string[] The authors of the application. Platform-specific - macOS: Unsupported. Source: undefined
comments? string Application comments. Platform-specific - macOS: Unsupported. Source: undefined
copyright? string The copyright of the application. Source: undefined
credits? string The credits. Platform-specific - Windows / Linux: Unsupported. Source: undefined
icon? | string | Image | ArrayBuffer | Uint8Array<ArrayBufferLike> | number[] The application icon. Platform-specific - Windows: Unsupported. Source: undefined
license? string The license of the application. Platform-specific - macOS: Unsupported. Source: undefined
name? string Sets the application name. Source: undefined
shortVersion? string The short version, e.g. “1.0”. Platform-specific - Windows / Linux: Appended to the end of version in parentheses. Source: undefined
version? string The application version. Source: undefined
website? string The application website. Platform-specific - macOS: Unsupported. Source: undefined
websiteLabel? string The website label. Platform-specific - macOS: Unsupported. Source: undefined

Source: undefined

Options for creating a new check menu item.

Property Type Description Inherited from Defined in
accelerator? string Specify an accelerator for the new menu item. MenuItemOptions.accelerator Source: undefined
action? (id) => void Specify a handler to be called when this menu item is activated. MenuItemOptions.action Source: undefined
checked? boolean Whether the new check menu item is enabled or not. - Source: undefined
enabled? boolean Whether the new menu item is enabled or not. MenuItemOptions.enabled Source: undefined
id? string Specify an id to use for the new menu item. MenuItemOptions.id Source: undefined
text string The text of the new menu item. MenuItemOptions.text Source: undefined

Source: undefined

Options for creating a new icon menu item.

Property Type Description Inherited from Defined in
accelerator? string Specify an accelerator for the new menu item. MenuItemOptions.accelerator Source: undefined
action? (id) => void Specify a handler to be called when this menu item is activated. MenuItemOptions.action Source: undefined
enabled? boolean Whether the new menu item is enabled or not. MenuItemOptions.enabled Source: undefined
icon? MenuIcon Icon to be used for the new icon menu item. Note that you may need the image-ico or image-png Cargo features to use this API. To enable it, change your Cargo.toml file: [dependencies] tauri = { version = "...", features = ["...", "image-png"] } - Source: undefined
id? string Specify an id to use for the new menu item. MenuItemOptions.id Source: undefined
text string The text of the new menu item. MenuItemOptions.text Source: undefined

Source: undefined

Options for creating a new menu item.

Property Type Description Defined in
accelerator? string Specify an accelerator for the new menu item. Source: undefined
action? (id) => void Specify a handler to be called when this menu item is activated. Source: undefined
enabled? boolean Whether the new menu item is enabled or not. Source: undefined
id? string Specify an id to use for the new menu item. Source: undefined
text string The text of the new menu item. Source: undefined

Source: undefined

Options for creating a new menu.

Property Type Description Defined in
id? string Specify an id to use for the new menu. Source: undefined
items? ( | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | MenuItemOptions | SubmenuOptions | IconMenuItemOptions | PredefinedMenuItemOptions | CheckMenuItemOptions)[] List of items to add to the new menu. Source: undefined

Source: undefined

Options for creating a new predefined menu item.

Property Type Description Defined in
item | "Separator" | "Copy" | "Cut" | "Paste" | "SelectAll" | "Undo" | "Redo" | "Minimize" | "Maximize" | "Fullscreen" | "Hide" | "HideOthers" | "ShowAll" | "CloseWindow" | "Quit" | "Services" | "BringAllToFront" | { About: | AboutMetadata | null; } The predefined item type Source: undefined
text? string The text of the new predefined menu item. Source: undefined

type SubmenuOptions = Omit<MenuItemOptions, "accelerator" | "action"> & MenuOptions & object;

Source: undefined

Name Type Description Defined in
icon? MenuIcon Icon to be used for the submenu. Note: you may need the image-ico or image-png Cargo features to use this API. Source: undefined

© 2026 Tauri Contributors. CC-BY / MIT