# Empty State

> Empty state placeholder with icon, title, description, and actions.

Registry name: `empty-state`. HTML docs: https://ui.anuragroy.dev/component/empty-state.

## Install

```bash
npx shadcn@latest add https://ui.anuragroy.dev/r/empty-state.json
```

If the website is down: `npx shadcn@latest add https://raw.githubusercontent.com/anurag-roy/ui.anuragroy.dev/main/public/r/empty-state.json`.

Registry JSON: https://ui.anuragroy.dev/r/empty-state.json (GitHub: https://raw.githubusercontent.com/anurag-roy/ui.anuragroy.dev/main/public/r/empty-state.json).

## Import

Import paths follow the consumer `components.json` aliases. After a default install:

```tsx
import {
  EmptyState,
  EmptyStateActions,
  EmptyStateDescription,
  EmptyStateIcon,
  EmptyStateTitle
} from "@/components/ui/empty-state"
```

## Usage

```tsx
import { Inbox } from "lucide-react"

import { Button } from "@/components/ui/button"
import {
  EmptyState,
  EmptyStateActions,
  EmptyStateDescription,
  EmptyStateIcon,
  EmptyStateTitle,
} from "@/components/ui/empty-state"

export function Example() {
  return (
    <EmptyState>
      <EmptyStateIcon>
        <Inbox />
      </EmptyStateIcon>
      <EmptyStateTitle>No results</EmptyStateTitle>
      <EmptyStateDescription>
        Try a different filter or clear your search.
      </EmptyStateDescription>
      <EmptyStateActions>
        <Button variant="secondary">Reset filters</Button>
      </EmptyStateActions>
    </EmptyState>
  )
}
```

## API

### EmptyState

Centered empty-state stack.

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `className` | string | — |  |

## See also

- [HTML page](https://ui.anuragroy.dev/component/empty-state): Preview and the same docs in the site chrome.
- [Registry item](https://ui.anuragroy.dev/r/empty-state.json): Source files and dependencies.
- [Catalog](https://ui.anuragroy.dev/component): All components.
- [llms.txt](https://ui.anuragroy.dev/llms.txt): Agent index for this library.