# Pop-up buttons

Source: https://developer.apple.com/design/human-interface-guidelines/pop-up-buttons
Skill: hig-components-menus
Snapshot: 2025-02-02

---
<!-- hig-doctor:attribution -->
> **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