Offering help

PatternsPatterns

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

Offering help

Best practices

Let your app’s tasks inform the types of help people might need.

Use relevant and consistent language and images in your help content.

Make sure all help content is inclusive.

Avoid bloating your help content by explaining how standard components or patterns work.

Creating tips

Use the most appropriate tip type for your app’s user interface.

Use tips for simple features.

Make tips short, actionable, and engaging.

Define rules to help ensure your tips reach the intended audience.

If there’s an image or symbol that people associate with the feature, consider including it in the tip, and prefer the filled variant.

Use buttons to direct people to information or options.

Platform considerations

macOS, visionOS

Describe only the control that people indicate interest in.

Explain the action or task the control initiates.

In general, avoid repeating a control’s name in its tooltip.

Be brief.

Use sentence case.

Consider offering context-sensitive tooltips.

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/offering-help

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.