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.

Labels

  • 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.

Platform considerations

macOS

watchOS

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/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/apple-hig-skills
Email updates aren't configured on this deployment yet. Follow the GitHub repo (opens in new tab) for updates.