Disclosure controls

On this page3 sections

Best practices

Use a disclosure control to hide details until they’re relevant.

Disclosure triangles

  • Collapsed
  • Expanded

Provide a descriptive label when using a disclosure triangle.

Disclosure buttons

  • Collapsed
  • Expanded

Place a disclosure button near the content that it shows and hides.

Use no more than one disclosure button in a single view.


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

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.