UNPKG

apple-dev-mcp

Version:

Complete Apple development guidance: Human Interface Guidelines (design) + Technical Documentation for iOS, macOS, watchOS, tvOS, and visionOS

15 lines (14 loc) 1.8 kB
--- title: Dock Menus platform: macOS category: foundations url: https://developer.apple.com/design/human-interface-guidelines/dock-menus quality_score: 0.37 content_length: 1433 last_updated: 2025-07-20T03:46:38.779Z keywords: ["dock menus","macos","foundations","system","interface"] has_code_examples: false has_images: false is_fallback: false --- Dock menus On a Mac, people can secondary click an app’s or game’s icon in the Dock to reveal a Dock menu, which presents both system-provided and custom items. The system-provided Dock menu items can vary depending on whether the app is open. For example, the Dock menu for Safari includes menu items for actions like viewing a current window or creating a new window. Note Although i OS and i Pad OS don’t support a Dock menu, people can reveal a similar menu of system-provided and custom items — called Home Screen quick actions — when they long press an app icon on the Home Screen or in the Dock. For guidance, see Home Screen quick actions. Best practices As with all menus, you need to label Dock menu items succinctly and organize them logically. For guidance, see Menus. Make custom Dock menu items available in other places, too. Not everyone uses a Dock menu, so it’s important to offer the same commands elsewhere, like in your menu bar menus or within your interface. Prefer high-value custom items for your Dock menu. For example, a Dock menu can list all currently or recently open windows, making it a convenient way to jump to the window people want. Also consider listing a few of the actions that are most likely to be useful when your app isn’t frontmost or when there are no open windows. For example, Mail includes items for getting new mail and composing a new message in addition to listing all open windows.