Apple Human Interface Guidelines: Alerts
Explains alert use, interruption cost, destructive-action confirmation, and platform distinctions.
What this source can teach
Use this source to understand a platform convention and the setting it was designed for.
- Start with the original. Open the source and find the guidance or example relevant to your task.
- Trace the connection. Use the claim notes below to see how this site applies the source to specific patterns.
- Check the setting. Compare the source's platform, people, and constraints with your own decision.
Pattern Decisions This Source Supports
| Pattern | Supported decision | Required contract | Claim note |
|---|---|---|---|
| Alert dialog | Choose an alert dialog when an important message interrupts the current workflow and requires an immediate user response. | The alert dialog appears only for a condition that genuinely requires a response before continuation. | Apple alert guidance explains the interruption cost and appropriate critical-use threshold. |
| Ambiguous destructive action copy | Flag this anti-pattern when the destructive or safe action label does not name what will happen. | Every destructive control label must answer what action will happen and what object or scope it affects. | Apple alert guidance supports clear action wording and careful treatment of destructive choices. |
| Confirmation dialog | Choose confirmation when the action has a clear reason not to proceed and the user may change their mind after seeing the consequence. | The confirmation appears only after a user-initiated action, not as surprise interruption unrelated to the current command. | Apple alert guidance distinguishes uncommon destructive actions that cannot be undone from common undoable actions. |
| Confirmation fatigue | Flag this anti-pattern when low-risk, reversible, or high-frequency actions repeatedly open modal confirmations. | Each confirmation must have a documented risk, consequence, and reason it is better than undo, prevention, warning text, review, or clearer command placement. | Apple alert guidance distinguishes uncommon destructive decisions from common actions that can use undo or other feedback. |
| Destructive action confirmation | Choose destructive action confirmation when a destructive command needs a final commit review before permanent or externally visible loss. | The confirmation appears only after a user-initiated destructive command. | Apple alert guidance supports deliberate destructive-action treatment and warns against ambiguous confirmation labels. |
| Modal dialog | Choose a modal dialog for a short contained task that must temporarily suspend interaction with the page behind it. | Opening the modal moves focus to the best starting element inside the dialog, not to the dimmed page. | Helps distinguish interruptive alert-style decisions from ordinary focused modal tasks. |
| Undo | Choose undo when the product can restore the exact prior state without data loss or unrecoverable side effects. | The undo affordance appears after the action completes and names what will be restored. | Apple alert guidance distinguishes common undoable destructive actions from uncommon irreversible actions that need alerts. |
Comparisons supported by this source
- Alert dialog vs alert vs modal dialog vs confirmation dialog
Apple alert guidance frames alerts as interruptive and appropriate only for important information.
- Ambiguous destructive action copy vs destructive action confirmation vs typed confirmation vs dangerous-action review vs confirmation fatigue vs warning text
Apple alert guidance supports clear action wording and careful treatment of destructive choices.
- Confirmation fatigue vs confirmation dialog vs destructive action confirmation vs undo vs warning text vs dangerous-action review
Apple alert guidance supports reserving alerts for important choices and avoiding alerts for common undoable actions.
- Destructive action confirmation vs confirmation dialog vs undo vs warning text
Apple alert guidance supports careful destructive-action treatment and warns that unclear OK-style labels can be ambiguous.
- Modal dialog vs confirmation dialog
Apple guidance frames alerts as interruptive and appropriate only for critical information.
- Undo vs confirmation dialog
Apple's alert guidance distinguishes uncommon irreversible actions from undoable destructive actions.
Evidence Role
This source is treated as platform-guideline evidence. Its value comes from the specific claims and setting described above.
Publisher: Apple. Last checked: .