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.
<!-- hig-doctor:canonical-footer -->
For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/activity-views