Skip to content

EmptyState

Shared Components

Placeholder display for empty data states with icon, title, description, and optional action button.

Illustrated empty stateRecovery actionCompleted action
Open preview

Responsive viewport — resize the window to explore. Direction and density apply only to this preview. Theme applies to the docs too.

Usage

Explain why a section is empty and provide a useful next action. Use different wording for a new workspace and an unmatched search.

Import
import { EmptyState } from "@dashboardpack/core/components/shared/empty-state";

Available in the included @dashboardpack/core package. Copy the complete example from Source code for all imports and state. Add "use client" when using hooks or event handlers. See installation and theming for project setup.

API reference

Common props and defaults. Slot-specific props are named below; native elements also accept their standard HTML attributes. The component TypeScript definitions are the complete type reference.

EmptyState props
PropType / DefaultDescription
titlestring

Default: required

Primary empty-state message.
descriptionstring

Default: —

Context and suggested next step.
iconReactNode

Default: —

Optional decorative illustration or icon.
actionReactNode

Default: —

Optional button or link.
classNamestring

Default: —

Extend container spacing.

Build with these too