Context menus

ComponentsMenus & Actions

Source: Apple Inc. Canonical content at https://developer.apple.com/design/human-interface-guidelines/context-menus. This file is a structured index of that content, snapshot 2025-02-02. Apple HIG text and imagery are © Apple Inc.; this repository provides organization and cross-referencing for AI agent consumption only.

Context menus

  • The system-defined touch or pinch and hold gesture in visionOS, iOS, and iPadOS

  • Pressing the Control key while clicking a pointing device in macOS and iPadOS

  • Using a secondary click on a Magic Trackpad in macOS or iPadOS

Best practices

Prioritize relevancy when choosing items to include in a context menu.

Aim for a small number of menu items.

Support context menus consistently throughout your app.

Always make context menu items available in the main interface, too.

If you need to use submenus to manage a menu’s complexity, keep them to one level.

Hide unavailable menu items, don’t dim them.

Aim to place the most frequently used menu items where people are likely to encounter them first.

Show keyboard shortcuts in your app’s main menus, not in context menus.

Follow best practices for using separators.

In iOS, iPadOS, and visionOS, warn people about context menu items that can destroy data.

Content

Include a title in a context menu only if doing so clarifies the menu’s effect.

Represent menu item actions with familiar icons.

Platform considerations

iOS, iPadOS

Provide either a context menu or an edit menu for an item, but not both.

In iPadOS, consider using a context menu to let people create a new object in your app.

Prefer a graphical preview that clarifies the target of a context menu’s commands.

Ensure that your preview looks good as it animates.

macOS

visionOS

Consider using a context menu instead of a panel or inspector window to present frequently used functionality.

In general, avoid letting a context menu’s height exceed the height of the window.

Resources

Developer documentation

Change log


For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/context-menus

Get HIG guidance in your AI

Install Apple HIG Skills and get expert design guidance directly in Claude Code.

npx skills add raintree-technology/apple-hig-skills
Email updates aren't configured on this deployment yet. Follow the GitHub repo (opens in new tab) for updates.