pattern-library 2 linked patterns 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.
Read with a purpose
What this source can teach
Use this source to compare a documented solution with the task and states in your own product.
- 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 |
|---|---|---|---|
| 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. |
Comparisons supported by this source
- Dead-end empty state vs empty state vs no-results recovery vs error state
Polaris documents focused empty-state explanation with primary and optional secondary actions.
Evidence Role
This source is treated as pattern-library evidence. Its value comes from the specific claims and setting described above.
Publisher: Shopify Polaris. Last checked: .