GitHub 560+

Empty

Displays an empty state placeholder with optional media, title, and description.

404 - Page Not Found
The page you are looking for does not exist.

Installation

npx shadcn@latest add @fulldev/empty

Usage

import {
  Empty,
  EmptyContent,
  EmptyDescription,
  EmptyMedia,
  EmptyTitle,
} from "@/components/ui/empty"
<Empty>
  <EmptyMedia>
    <Icon name="inbox" />
  </EmptyMedia>
  <EmptyTitle>No results</EmptyTitle>
  <EmptyDescription> Try adjusting your filters. </EmptyDescription>
</Empty>

Composition

Use the following composition to build an Empty state:

Empty
├── EmptyHeader
│   ├── EmptyMedia
│   ├── EmptyTitle
│   └── EmptyDescription
└── EmptyContent

Notes

  • Use EmptyHeader when you want the media, title, and description grouped as one block.
  • EmptyMedia variant="icon" is a good default for simple status states.
  • Add EmptyContent only when the empty state needs an action such as retry, clear filters, or go back.

API Reference

See the GitHub source code for more information on props.