pattern-library checked
Shopify Polaris Empty State
Documents empty states for missing content or first-use setup with focused explanation, illustration, primary action, and optional secondary action.
Pattern Decisions This Source Supports
| Pattern | Supported decision | Required contract | Claim note |
|---|---|---|---|
| Dead-end empty state | Flag dead-end empty state when a blank area lacks a specific object name, cause, and reachable next action. | A blank or actionless content region is not a valid terminal state. | Polaris documents empty states with focused explanation, illustration, primary action, and optional secondary action. |
| Empty state | Choose empty state only after the system knows the area is legitimately empty rather than loading, filtered, or failed. | The empty state identifies what is absent and why the absence is expected. | Polaris documents empty states for missing content or first-use setup with focused explanation, illustration, and primary/secondary actions. |
Evidence Role
This source is treated as pattern-library evidence. Use it to validate the decision rules above, not as a visual style reference.
Publisher: Shopify Polaris. Last checked: .