MDN self-hosted library · e01.org

menus.ContextType

The different contexts a menu item can appear in.

no runnable cells webextension-api-type upstream source

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.
  • link
  • : 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.