Searching

Patterns
View as Markdown
On this page2 sections

Best practices

If search is important, consider making it a primary action.

Aim to make your app’s content searchable through a single location.

Use placeholder text to indicate what content is searchable.

Clearly display the current scope of a search.

Provide suggestions to make searching easier.

Take privacy into consideration before displaying search history.

Make your app’s content searchable in Spotlight.

Define metadata for custom file types you handle.

Use Spotlight to offer advanced file-search capabilities within the context of your app.

Prefer using the system-provided open and save views.

Implement a Quick Look generator if your app produces custom file types.


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

Apple HIG text and imagery are © Apple Inc. This page is a structured index of Apple’s canonical documentation (snapshot 2025-02-02), provided for quick reference and AI-agent consumption — it isn’t affiliated with or endorsed by Apple. Read the original at developer.apple.com (opens in new tab).

Get HIG guidance in your AI

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