For AI Agents
Hand your agent this brief or the ReUI MCP, not a screenshot. Installs with a ReUI Pro or Ultimate license.
When to use
- A first run screen for records, projects, reports or a library that holds nothing yet
- A search with zero matches or an export page that has nothing to download yet
- A setup prompt to invite the team, enable a feature or connect file storage
When not to use
- A compact no data message placed inside a table, list or panel you already have: use the Empty component
- Only the layered isometric illustration, with no title, copy or actions: use the Icon Stack component
- A populated tile that shows stats, a profile, links or an integration: use the Card blocks
Agent notes
EmptyStatetakes no props in every block, so its copy, media and actions are fixed in the block files; add props to reuse it- Every page.tsx centers
EmptyStatein amin-h-svhwrapper with padding; drop that wrapper inside your own layout - No action is wired: buttons have no
onClickor only fire a sonnertoast, and everyhrefis a hash anchor
Third-party API docs
- Sonner v2: API reference, docs, used by 1 of 14 blocks
Markdown
https://web.dev.reui.io/blocks/application/empty-state.mdMCP
search({ query: "empty state", type: "block", category: "empty-state" })Shadcn Empty State Blocks: No Data Screens with Recovery Actions
The empty state is the most visited screen in a new product and the least designed. These blocks give it an icon or illustration, a sentence that explains, and the one action that fixes it: import, create, invite, clear the filter, retry.
All Empty State Blocks
Open any block on its own page for a live preview, the components it is built from, and the install command.
- Data Import Start Records empty state with stacked-cards illustration, dual primary actions, and quick-guide link rows
- No Search Results Search no-results empty state with suggestion chips and a stacked result-card illustration
- First Project Projects empty state with hero illustration, dual actions, and quick-start template list
- Reports Workspace Two-column reports empty state with icon, dual actions, and preview screenshot slot
- Empty Report Brief Two-column empty state in a ReUI Frame with icon, dual actions, and a preview panel
- Team Launch Steps Team workspace onboarding empty state with two action buttons and three colored setup-step tiles
- Invite First Member Workspace member invite empty state with circular icon and dual invite and copy-link buttons
- Settings Setup Tabs Project settings empty state with line tabs and per-section setup prompts
- Invite Members Prompt Workspace member invite empty state with layered 3D icon-stack illustration and dual invite actions
- Blueprint Library Card-wrapped empty state with section heading and horizontal media-beside-text layout
- Section Add Prompt Section-header empty state with action button above a muted card and stacked icon illustration
- Export Filters Activity exports empty state with audience, workspace, and date-range filter toolbar
- Cloud Storage Connect File sources empty state with cloud storage connector grid (Dropbox, R2, Drive, OneDrive)
- Enable Organizations Organizations setup empty state with framed enable card, building icon, and tooltip help link
What the Empty State blocks cover
Application screens, each a full block with fixture data:
- Records empty state with stacked-cards illustration, dual primary actions, and quick-guide link rows
- Search no-results empty state with suggestion chips and a stacked result-card illustration
- Projects empty state with hero illustration, dual actions, and quick-start template list
- Two-column reports empty state with icon, dual actions, and preview screenshot slot
- Two-column empty state in a ReUI Frame with icon, dual actions, and a preview panel
- Team workspace onboarding empty state with two action buttons and three colored setup-step tiles
- Workspace member invite empty state with circular icon and dual invite and copy-link buttons
- Project settings empty state with line tabs and per-section setup prompts
- Workspace member invite empty state with layered 3D icon-stack illustration and dual invite actions
- Card-wrapped empty state with section heading and horizontal media-beside-text layout
Built from
All Shadcn Block Groups
Browse the full ReUI Shadcn blocks library by product surface. Each group bundles category-level blocks you can mix and match across your project.
- Shadcn Application Blocks (303) Browse 303 Shadcn Application blocks across 23 categories.
- Shadcn Data Grid Blocks (47) Browse 47 Shadcn Data Grid blocks across 9 categories.
- Shadcn Charts Blocks (52) Browse 52 Shadcn Charts blocks across 10 categories.
- Shadcn Solutions Blocks (76) Browse 76 Shadcn Solutions blocks across 11 categories.
- Shadcn AI & Agents Blocks (22) Browse 22 Shadcn AI & Agents blocks across 3 categories.
- Shadcn eCommerce Blocks (87) Browse 87 Shadcn eCommerce blocks across 13 categories.
- Shadcn Marketing Blocks (67) Browse 67 Shadcn Marketing blocks across 8 categories.
Frequently Asked Questions
Can I swap the illustration?
Yes. The slot takes any node; the blocks use the ReUI Icon Stack for the illustrated variants and a plain icon for the compact ones.
How do I install an Empty State block?
Open the block on its page, copy the install command (the shadcn CLI with the @reui registry and your license key) or the AI prompt, and run it in your project. The block, its fixtures and every ReUI and shadcn dependency land in one command.
Is a license needed?
Empty State blocks are part of ReUI Pro: one payment, lifetime updates, every block in every style. The ReUI primitives and the free examples they build on install with no license.
Start building with ReUI Pro today.
Every Pro block, every style, and every future addition, with one license for unlimited projects.
Get All-Access
From $249, once. Lifetime updates.