Ornaments

ComponentsLayout

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

Ornaments

Best practices

Consider using an ornament to present frequently needed controls or information in a consistent location that doesn’t clutter the window.

In general, keep an ornament visible.

If you need to display multiple ornaments, prioritize the overall visual balance of the window.

Aim to keep an ornament’s width the same or narrower than the width of the associated window.

Consider using borderless buttons in an ornament.

Use system-provided toolbars and tab bars unless you need to create custom components.

Platform considerations

Resources

Developer documentation

Videos

Change log


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

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.