Activity views

ComponentsContent

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

Activity views

Best practices

Avoid creating duplicate versions of common actions that are already available in the activity view.

Consider using a symbol to represent your custom activity.

Write a succinct, descriptive title for each custom action you provide.

Make sure activities are appropriate for the current context.

Use the Share button to display an activity view.

Share and action extensions

  • In iOS and iPadOS, share and action extensions are displayed in the share sheet that appears when people choose an Action button.

  • In macOS, people access share extensions by clicking a Share button in the toolbar or choosing Share in a context menu. People can access an action extension by holding the pointer over certain types of embedded content — like an image they add to a Mail compose window — clicking a toolbar button, or choosing a quick action in a Finder window.

If necessary, create a custom interface that feels familiar to people.

Streamline and limit interaction.

Avoid placing a modal view above your extension.

If necessary, provide an image that communicates the purpose of your extension.

Use your main app to denote the progress of a lengthy operation.

Platform considerations

Resources

Developer documentation

Videos


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

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.