apple-hig-mcp/content/pop-up-buttons.md

High-performance MCP server providing instant access to Apple's Human Interface Guidelines via hybrid static/dynamic content delivery

---
title: "Pop-up Buttons"
platform: universal
category: visual-design
url: https://developer.apple.com/design/human-interface-guidelines/pop-up-buttons
id: pop-up-buttons
lastUpdated: 2025-07-01T00:52:45.384Z
extractionMethod: enhanced-turndown
qualityScore: 0.710
confidence: 0.910
contentLength: 2528
structureScore: 0.500
cleaningScore: 0.116
hasCodeExamples: false
hasImages: false
keywords: ["pop", "buttons", "button", "displays", "menu", "mutually", "exclusive", "options", "after", "people"]
---
## Overview

Pop-up buttons A pop-up button displays a menu of mutually exclusive options. After people choose an item from a pop-up button’s menu, the menu closes, and the button can update its content to indicate the current selection. Best practices Use a pop-up button to present a flat list of mutually exclusive options or states. A pop-up button helps people make a choice that affects their content or the surrounding view. Use a pull-down button instead if you need to: Offer a list of actions Let people select multiple items Include a submenu Provide a useful default selection. A pop-up button can update its content to identify the current selection, but if people haven’t made a selection yet, it shows the default item you specify. When possible, make the default selection an item that most people are likely to want. Give people a way to predict a pop-up button’s options without opening it. For example, you can use an introductory label or a button label that describes the button’s effect, giving context to the options. Consider using a pop-up button when space is limited and you don’t need to display all options all the time. Pop-up buttons are a space-efficient way to present a wide array of choices. If necessary, include a Custom option in a pop-up button’s menu to provide additional items that are useful in some situations. Offering a Custom option can help you avoid cluttering the interface with items or controls that people need only occasionally. You can also display explanatory text below the list to help people understand how the options work. Platform considerations No additional considerations for iOS, macOS, or visionOS. Not supported in tvOS or watchOS. 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. For example, people can quickly choose an option from the pop-up button’s menu without navigating to a detail view. Consider using a pop-up button in this scenario when you have a fairly small, well-defined set of options that work well in a menu. Resources Related Pull-down buttons Buttons Menus Developer documentation MenuPickerStyle — SwiftUI changesSelectionAsPrimaryAction — UIKit NSPopUpButton — AppKit Change log Date Changes October 24, 2023 Added artwork. September 14, 2022 Added a guideline on using a pop-up button in a popover or modal view in iPadOS. Current page is Pop-up buttons Supported platforms Pop-up buttons Best practices Platform considerations Resources Change log

## Related Concepts

- buttons
- button

---

**Attribution Notice**

This content is sourced from Apple's Human Interface Guidelines: https://developer.apple.com/design/human-interface-guidelines/pop-up-buttons

This content was extracted with good confidence. Structure and guidelines have been enhanced for better usability.

© Apple Inc. All rights reserved. This content is provided for educational and development purposes under fair use. This MCP server is not affiliated with Apple Inc. and does not claim ownership of Apple's content.

For the most up-to-date and official information, please refer to Apple's official documentation.