Empty

Use the Empty component to display an empty state.

No projects yet

You haven't created any projects yet. Get started by creating your first project.

import { IconFolderCode } from "@tabler/icons-react"
import { ArrowUpRightIcon } from "lucide-react"

Installation


pnpm dlx shadcn@latest add @dots/empty

Usage

import {
  Empty,
  EmptyContent,
  EmptyDescription,
  EmptyHeader,
  EmptyMedia,
  EmptyTitle,
} from "@/components/ui/empty"

<Empty>
  <EmptyHeader>
    <EmptyMedia variant="icon">
      <Icon />
    </EmptyMedia>
    <EmptyTitle>No data</EmptyTitle>
    <EmptyDescription>No data found</EmptyDescription>
  </EmptyHeader>
  <EmptyContent>
    <Button>Add data</Button>
  </EmptyContent>
</Empty>

Composition

Use the following composition to build an Empty state:

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

Outline

Use the border utility class to create an outline empty state.

No files yet

Upload files to your storage to open them on any device.

import { IconCloud } from "@tabler/icons-react"

import { Button } from "@/components/ui/button"

Background

Use the bg-* and bg-gradient-* utilities to add a background to the empty state.

No notifications

You're all caught up. New notifications will appear here.

import { IconBell } from "@tabler/icons-react"
import { RefreshCcwIcon } from "lucide-react"

Avatar

Use the EmptyMedia component to display an avatar in the empty state.

Sam is offline

Leave a message and Sam will see it next time they open the app.

import {
  Avatar,
  AvatarFallback,

Avatar Group

Use the EmptyMedia component to display an avatar group in the empty state.

No team members

Invite your team to work on this project together.

import { PlusIcon } from "lucide-react"

import {

InputGroup

You can add an InputGroup component to the EmptyContent component.

Page not found

The page you're looking for doesn't exist. Try searching for what you need below.

/

Need help? Contact support

import { SearchIcon } from "lucide-react"

import {

API Reference

Empty

The main component of the empty state. Wraps the EmptyHeader and EmptyContent components.

Prop	Type	Default
`className`	`string`

<Empty>
  <EmptyHeader />
  <EmptyContent />
</Empty>

EmptyHeader

The EmptyHeader component wraps the empty media, title, and description.

Prop	Type	Default
`className`	`string`

<EmptyHeader>
  <EmptyMedia />
  <EmptyTitle />
  <EmptyDescription />
</EmptyHeader>

EmptyMedia

Use the EmptyMedia component to display the media of the empty state such as an icon or an image. You can also use it to display other components such as an avatar.

Prop	Type	Default
`variant`	`"default" \| "icon"`	`default`
`className`	`string`

<EmptyMedia variant="icon">
  <Icon />
</EmptyMedia>

<EmptyMedia>
  <Avatar>
    <AvatarImage src="..." />
    <AvatarFallback>CN</AvatarFallback>
  </Avatar>
</EmptyMedia>

EmptyTitle

Use the EmptyTitle component to display the title of the empty state.

Prop	Type	Default
`className`	`string`

<EmptyTitle>No data</EmptyTitle>

EmptyDescription

Use the EmptyDescription component to display the description of the empty state.

Prop	Type	Default
`className`	`string`

<EmptyDescription>You do not have any notifications.</EmptyDescription>

EmptyContent

Use the EmptyContent component to display the content of the empty state such as a button, input or a link.

Prop	Type	Default
`className`	`string`

<EmptyContent>
  <Button>Add Project</Button>
</EmptyContent>

Dropdown Menu Entity Avatar

On This Page

Installation Usage Composition Outline Background Avatar Avatar Group InputGroup API Reference Empty EmptyHeader EmptyMedia EmptyTitle EmptyDescription EmptyContent