Pull-down buttons

ComponentsMenus & Actions

Source: Apple Inc. Canonical content at https://developer.apple.com/design/human-interface-guidelines/pull-down-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.

Pull-down buttons

Best practices

Use a pull-down button to present commands or items that are directly related to the button’s action.

  • An Add button could present a menu that lets people specify the item they want to add.

  • A Sort button could use a menu to let people select an attribute on which to sort.

  • A Back button could let people choose a specific location to revisit instead of opening the previous one.

Avoid putting all of a view’s actions in one pull-down button.

Balance menu length with ease of use.

Display a succinct menu title only if it adds meaning.

Let people know when a pull-down button’s menu item is destructive, and ask them to confirm their intent.

Include an interface icon with a menu item when it provides value.

Platform considerations

iOS, iPadOS

Consider using a More pull-down button to present items that don’t need prominent positions in the main interface.

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/pull-down-buttons

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.