Labels

ComponentsControls

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

  • Within a button, a label generally conveys what the button does, such as Edit, Cancel, or Send.

  • Within many lists, a label can describe each item, often accompanied by a symbol or an image.

  • Within a view, a label might provide additional context by introducing a control or describing a common action or task that people can perform in the view.

Best practices

Use a label to display a small amount of text that people don’t need to edit.

Prefer system fonts.

Use system-provided label colors to communicate relative importance.

Make useful label text selectable.


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

Get HIG guidance in your AI

Install Apple HIG Skills and get expert 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.