platform-guideline checked
Apple Human Interface Guidelines: Alerts
Explains alert use, interruption cost, destructive-action confirmation, and platform distinctions.
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. |
Evidence Role
This source is treated as platform-guideline evidence. Use it to validate the decision rules above, not as a visual style reference.
Publisher: Apple. Last checked: .