# Disclosure controls

Source: https://developer.apple.com/design/human-interface-guidelines/disclosure-controls
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/disclosure-controls.
> 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.

# Disclosure controls

## 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.**

---

<!-- 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/disclosure-controls