Empty

A composable empty state component for displaying when there is no content, such as empty search results, empty lists, or first-time experiences.

View Markdown

Default

Welcome to your dashboard

Get started by creating your first project. It only takes a few minutes to set up.

With Background

Your inbox is empty

New messages will appear here when you receive them.

API Reference

EmptyRoot

Container component that centers content and provides size variants.

PropTypeDefaultDescription
size'sm' | 'md' | 'lg''md'Controls padding and gap of the empty state
classNamestring-Additional CSS classes
...propsReact.ComponentProps<"div">-Standard div element props

EmptyBackground

Absolutely positioned decorative background with a radial gradient mask. Marked as aria-hidden.

PropTypeDefaultDescription
classNamestring-Additional CSS classes
...propsReact.ComponentProps<"div">-Standard div element props

EmptyIcon

Rounded container for icons or illustrations with a muted background.

PropTypeDefaultDescription
size'sm' | 'md' | 'lg''md'Size of the media container and inner icon
classNamestring-Additional CSS classes
...propsReact.ComponentProps<"div">-Standard div element props

EmptyTitle

Heading element for the empty state message.

PropTypeDefaultDescription
asReact.ElementType'h2'HTML element to render as (e.g. h3, h4)
classNamestring-Additional CSS classes
...propsReact.ComponentProps<"h2">-Standard heading element props

EmptyDescription

Muted paragraph text with constrained width for readability.

PropTypeDefaultDescription
classNamestring-Additional CSS classes
...propsReact.ComponentProps<"p">-Standard paragraph element props

EmptyActions

Flex container for action buttons.

PropTypeDefaultDescription
classNamestring-Additional CSS classes
...propsReact.ComponentProps<"div">-Standard div element props