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
Related
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