menus.ContextType

The different contexts a menu item can appear in.

Type

Values of this type are strings. The item is displayed when the given context applies. Possible values are:

all

Specifying 'all' is equivalent to the combination of all other contexts except for 'bookmark', 'tab' and 'tools_menu'.

action

Applies when the user context-clicks your browser action in a Manifest V3 extension. The maximum number of items that can be added to the top-level browser action context menu is menus.ACTION_MENU_TOP_LEVEL_LIMIT, but you can add any number of items to submenus.

audio

Applies when the user context-clicks an audio element.

bookmark

Applies when the user context-clicks a bookmark item in the bookmarks toolbar, bookmarks menu, bookmarks sidebar (Ctrl+B) and the Library window (Ctrl+Shift+B). The latter two are supported as of Firefox 66. Requires the "bookmarks" API permission in the manifest.

browser_action

Applies when the user context-clicks your browser action in a Manifest V2 extension. The maximum number of items that can be added to the top-level browser action context menu is menus.ACTION_MENU_TOP_LEVEL_LIMIT, but you can add any number of items to submenus.

editable

Applies when the user context-clicks an editable element, like a textarea.

frame

Applies when the user context-clicks in a nested iframe.

image

Applies when the user context-clicks an image.

Applies when the user context-clicks on a link.

page

Applies when the user context-clicks in the page, but none of the other page contexts apply (for example, the click is not on an image or a nested iframe or a link).

page_action

Applies when the user context-clicks your page action. The maximum number of items that can be added to the top-level page action context menu is menus.ACTION_MENU_TOP_LEVEL_LIMIT, but you can add any number of items to submenus.

password

Applies when the user context-clicks on a password input element.

selection

Applies when part of the page is selected.

tab

Applies when the user context-clicks on a tab (specifically, this refers to the tab-strip or other user interface element enabling the user to switch from one browser tab to another, not to the page itself).

Clicking the menu item on a tab grants the activeTab permission for the tab clicked, even if that isn't the active tab.

tools_menu

The item is added to the browser's tools menu.

video

Applies when the user context-clicks a video element.

Note that "launcher" is not supported.

Browser compatibility

Note: This API is based on Chromium's chrome.contextMenus API. This documentation is derived from context_menus.json in the Chromium code.