An empty state should explain the missing content and offer an action the current user can perform. First use, filtered results and permission limits need different treatment.
Diagnose the cause
In a fictional contract workspace, an empty list may mean nobody has uploaded a document, the current filter excludes everything or the user lacks access. Reusing “Create your first contract” for every case can cause duplicate work and confusing permission errors.
| Cause | Explanation | Next action |
|---|---|---|
| New workspace | No contracts have been added here | Add or import |
| Restrictive filters | No contracts match these filters | Clear the filters |
| Restricted access | This workspace requires approval | Contact its named owner |
Keep examples separate from real activity
Sample records can explain an unfamiliar interface. Label them clearly, provide a removal path and prevent them from triggering external messages or billing. A fictional revenue chart must not look like the customer's actual performance. Consider whether a read-only preview would teach the same concept with less confusion.
Test the transition back to content
Try creation, import and filter reset with the actual role that sees the message. After success, remove the obsolete empty state and make the new record discoverable. A background import needs a progress state rather than a misleading empty list.
Should every empty state offer creation?
No. Read-only users may need to join an existing team or wait for an administrator. Explain that dependency. A useful empty state makes the next decision clear, even when the user cannot complete it alone.
An empty cross-region report
A regional manager may see no activity because the report defaults to headquarters time. Show the time window and region before suggesting data creation. An empty state caused by reporting scope should not encourage users to duplicate existing work.
Sources and further reading
From this guide to your project
Product ↗
The experience connects your promise to the job your user needs to get done. We design that journey before adding more screens.
Tell us about your ideaExamples are educational and do not describe client results. Content prepared with AI assistance; see our editorial policy. Our method ↗