Popovers

On this page2 sections

Best practices

Use a popover to expose a small amount of information or functionality.

Consider using popovers when you want more room for content.

Position popovers appropriately.

Use a Close button for confirmation and guidance only.

Always save work when automatically closing a nonmodal popover.

Show one popover at a time.

Don’t show another view over a popover.

When possible, let people close one popover and open another with a single click or tap.

Avoid making a popover too big.

Provide a smooth transition when changing the size of a popover.

Avoid using the word popover in help documentation.

Avoid using a popover to show a warning.

Platform considerations

iOS, iPadOS

Avoid displaying popovers in compact views.

macOS

  • Attached popover
  • Detached popover

Consider letting people detach a popover.

Make minimal appearance changes to a detached popover.


For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/popovers

Apple HIG text and imagery are © Apple Inc. This page is a structured index of Apple’s canonical documentation (snapshot 2025-02-02), provided for quick reference and AI-agent consumption — it isn’t affiliated with or endorsed by Apple. Read the original at developer.apple.com (opens in new tab).

Get HIG guidance in your AI

Install HIG Doctor and get expert Apple design guidance directly in Claude Code.

npx skills add raintree-technology/hig-doctor
Email updates aren't configured on this deployment yet. Follow the GitHub repo (opens in new tab) for updates.