# Context menu

> Mediated Wiki article. Canonical URL: https://mediated.wiki/source/Context_menu
> Markdown URL: https://mediated.wiki/source/Context_menu.md
> Source: https://en.wikipedia.org/wiki/Context_menu
> Source revision: 1348078919
> License: Creative Commons Attribution-ShareAlike 4.0 International (https://creativecommons.org/licenses/by-sa/4.0/)

User interface element

A context menu from [LibreOffice Writer](/source/LibreOffice_Writer), appearing when the user right-clicks on a page element

A context menu from [Ubuntu](/source/Ubuntu) desktop

A **context menu** (also called **contextual**, **shortcut**, and **pop up** or **pop-up** **menu**) is a [menu](/source/Menu_(computing)) in a [graphical user interface](/source/Graphical_user_interface) (GUI) that appears upon user interaction, such as a right-click [mouse operation](/source/Mouse_(computing)#Operation). A context menu offers a limited set of choices that are available in the current state, or context, of the operating system or application to which the menu belongs. Usually the available choices are actions related to the [selected object](/source/Selection_(user_interface)). From a technical point of view, such a context menu is a [graphical control element](/source/Graphical_control_element_(software)).

## History

Context menus first appeared in the [Smalltalk](/source/Smalltalk) environment on the [Xerox Alto](/source/Xerox_Alto) computer, where they were called *pop-up menus*; they were invented by [Dan Ingalls](/source/Dan_Ingalls) in the mid-1970s.[1][2]

[Microsoft Office](/source/Microsoft_Office) v3.0 introduced the context menu for copy and paste functionality in 1990. [Borland](/source/Borland) demonstrated extensive use of the context menu in 1991 at the Second Paradox Conference in Phoenix Arizona. [Lotus 1-2-3](/source/Lotus_1-2-3)/G for [OS/2](/source/OS%2F2) v1.0 added additional formatting options in 1991. Borland [Quattro Pro](/source/Quattro_Pro) for Windows v1.0 introduced the Properties context menu option in 1992.

## Implementation

Context menus are opened via various forms of user interaction that target a region of the GUI that supports context menus. The specific form of user interaction and the means by which a region is targeted vary:

- On a computer running [Microsoft Windows](/source/Microsoft_Windows), [macOS](/source/MacOS), or [Unix](/source/Unix) running the [X Window System](/source/X_Window_System), clicking the secondary mouse button (usually the right button) opens a context menu for the region that is under the mouse pointer.

- For quickness, implementations may additionally support hold-and-release selection, meaning the pointer is held down and dragged, and released at desirable menu entry.

- On systems that support one-button mice, context menus are typically opened by pressing and holding the primary mouse button (this works on the icons in the Dock on [macOS](/source/MacOS)) or by pressing a keyboard/mouse button combination (e.g. Ctrl-mouse click in [Classic Mac OS](/source/Classic_Mac_OS) and macOS). A keyboard alternative for macOS is to enable [Mouse keys](/source/Mouse_keys) in [Universal Access](/source/Universal_Access). Then, depending on whether a laptop or compact or extended keyboard type is used, the shortcut is Function+Ctrl+5 or Ctrl+5 (numeric keypad) or Function+Ctrl+i (laptop).

- On systems with a [multi-touch](/source/Multi-touch) interface such as MacBook or Surface, the context menu can be opened by pressing or tapping with two fingers instead of just one.

- Some cameras on smartphones for example recognize a [QR code](/source/QR_code) when a picture is taken. Then a pop-up appears if you want to 'open' the QR content. This could be anything like a website or to configure your phone to connect to [Wi-Fi](/source/Wi-Fi).

- On some user interfaces, context menu items are accompanied by icons for quicker recognition upon navigation.[3]

- Context menus can also have a top row of icons only for quick access to most frequently used options.[4]

Windows mouse click behavior is such that the context menu doesn't open while the mouse button is pressed, but only opens the menu when the button is released, so the user has to click again to select a context menu item. This behavior differs from that of macOS and most free software GUIs.

- In Microsoft Windows, pressing the [Application key](/source/Menu_key) or Shift+F10 opens a context menu for the region that has [focus](/source/Focus_(computing)).

Context menus are sometimes hierarchically organized, allowing navigation through different levels of the menu structure. The implementations differ: [Microsoft Word](/source/Microsoft_Word) was one of the first applications to only show sub-entries of some menu entries after clicking an arrow icon on the context menu, otherwise executing an action associated with the parent entry. This makes it possible to quickly repeat an action with the parameters of the previous execution, and to better separate options from actions.

### X Window Managers

The following [window managers](/source/Window_manager) provide context menu functionality:

- [Awesome](/source/Awesome_(window_manager))

- [IceWM](/source/IceWM)—[middle-click](/source/Middle-click) and [right-click](/source/Right-click) context menus on [desktop](/source/Desktop_environment), [menu bar](/source/Menu_bar), [title bars](/source/Title_bar), and [title icon](https://en.wikipedia.org/w/index.php?title=Title_icon&action=edit&redlink=1)

- [olwm](/source/Olwm)

- [openbox](/source/Openbox)

- [sawfish](/source/Sawfish_(window_manager))

## Usability

Context menus have received some criticism from [usability](/source/Usability) analysts when improperly used, as some applications make certain features *only* available in context menus, which may confuse even experienced users (especially when the context menus can only be activated in a limited area of the application's client window).

Context menus usually open in a fixed position under the [pointer](/source/Elements_of_graphical_user_interfaces#Pointer), but when the pointer is near a screen edge the menu will be displaced - thus reducing consistency and impeding use of [muscle memory](/source/Muscle_memory). If the context menu is being triggered by keyboard, such as by using Shift + F10, the context menu appears near the focused widget instead of the position of the pointer, to save recognition efforts.

## In documentation

Microsoft's guidelines call for always using the term *context menu*, and explicitly deprecate *shortcut menu*.[5]

## See also

- [Menu key](/source/Menu_key)

- [Pie menu](/source/Pie_menu)

- [Screen hotspot](/source/Screen_hotspot)

## References

1. **[^](#cite_ref-1)** R. Keith Sawyer (2012). [*Explaining Creativity: The Science of Human Innovation*](https://books.google.com/books?id=auAXfVwNAJoC&q=Dan+Ingalls+pop+up+menu&pg=PA252). USA: Oxford University Press. [ISBN](/source/ISBN_(identifier)) [9780199737574](https://en.wikipedia.org/wiki/Special:BookSources/9780199737574).

1. **[^](#cite_ref-2)** Peter Seibel (September 16, 2009). [*Coders at Work: Reflections on the Craft of Programming*](https://books.google.com/books?id=nneBa6-mWfgC&q=Dan+Ingalls+pop+up+menu&pg=PA373). Apress. [ISBN](/source/ISBN_(identifier)) [9781430219484](https://en.wikipedia.org/wiki/Special:BookSources/9781430219484).

1. **[^](#cite_ref-3)** ["Samsung Galaxy S4 Internet Browser FAQ and User's Guide"](https://www.webcazine.com/6136/samsung-galaxy-s4-internet-browser-faq-and-users-guide/). *WEBcazine*. 8 May 2013.

1. **[^](#cite_ref-4)** ["Context menu items"](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Context_menu_items). *MDN Web Docs*. 6 November 2023.

1. **[^](#cite_ref-msmenu_5-0)** ["Menus"](https://msdn.microsoft.com/en-us/library/windows/desktop/dn742392.aspx). *Windows desktop applications - Guidelines*. Microsoft. 2011.

## External links

Look up ***[context menu](https://en.wiktionary.org/wiki/Special:Search/context_menu)*** in Wiktionary, the free dictionary.

Wikimedia Commons has media related to [Context menu](https://commons.wikimedia.org/wiki/Category:Context_menu).

v t e Graphical control elements Command input Adjustment handle Button Context menu Drop-down list Hamburger button Menu Pie menu Data input-output Checkbox Color picker Combo box Cycle button Date picker Grid view Toggle switch List box List builder Radio button Scrollbar Search box Slider Spinner Text box Informational Balloon help Head-up display in computing HUD in video games Icon Infobar Label Loading screen Progress indicator Progress bar Splash screen Throbber Sidebar Status bar Toast Tooltip Containers Accordion Tree view Client-side decoration Disclosure widget Frame / Fieldset Menu bar Panel Popover Ribbon Tab Toolbar Window Window decoration Workspace Navigational Address bar Bookmarks bar Breadcrumb navigation Hyperlink Navigation bar Virtual desktop Special windows Alert dialog box Dialog box File dialog Inspector window Modal window Palette window Related concepts File viewer List of graphical user interface elements Layout manager Look and feel Mouseover Scrolling Widget toolkit WIMP Zoomable user interface

---
Adapted from the Wikipedia article [Context menu](https://en.wikipedia.org/wiki/Context_menu) by Wikipedia contributors ([contributor history](https://en.wikipedia.org/wiki/Context_menu?action=history)). Available under [Creative Commons Attribution-ShareAlike 4.0 International](https://creativecommons.org/licenses/by-sa/4.0/). Changes may have been made.
