Source: Apple Inc. Canonical content at https://developer.apple.com/design/human-interface-guidelines/pop-up-buttons. 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.
Pop-up buttons
Best practices
Use a pop-up button to present a flat list of mutually exclusive options or states.
Offer a list of actions
Let people select multiple items
Include a submenu
Provide a useful default selection.
Give people a way to predict a pop-up button’s options without opening it.
Consider using a pop-up button when space is limited and you don’t need to display all options all the time.
If necessary, include a Custom option in a pop-up button’s menu to provide additional items that are useful in some situations.
Platform considerations
iPadOS
Within a popover or modal view, consider using a pop-up button instead of a disclosure indicator to present multiple options for a list item.
<!-- hig-doctor:canonical-footer -->
For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/pop-up-buttons