Skip to content

Empty

A static empty collection message with a heading, explanation, and next step.

Browsers
Chrome 123+Firefox 121+Safari 17.5+
Tier
0
Forced layout budget
0 ms
Axe budget
0
SSR compatible
Yes
Published contract
Test harness

Playground

Empty

No projects yet

Create a project to organize your work and invite your team.

Examples

No projects

Use the static composition for an empty collection and provide a clear next step.

No projects yet

Create a project to organize your work and invite your team.

import { Button, Empty, EmptyContent, EmptyDescription, EmptyTitle } from "@gunkin/uiify";

export default function Example() {
  return (
    <Empty>
      <EmptyTitle>No projects yet</EmptyTitle>
      <EmptyDescription>Create a project to organize your work and invite your team.</EmptyDescription>
      <EmptyContent><Button as="a" href="/projects/new" variant="link">Create a project</Button></EmptyContent>
    </Empty>
  );
}

API

Empty

PropTypeDefaultDescription
childrenReactNode—Title, description, and optional next-step content.
className / style / ref / native section propsnative section props—Native section props, styles, events, and ref are forwarded.
renderReactElement | ((props, state) => ReactElement)—Replace the rendered element while keeping behavior and accessibility wiring.

EmptyTitle

PropTypeDefaultDescription
childrenReactNode—Content for this semantic empty-state part.
renderReactElement | ((props, state) => ReactElement)—Replace the rendered element while keeping behavior and accessibility wiring.

EmptyDescription

PropTypeDefaultDescription
childrenReactNode—Content for this semantic empty-state part.
renderReactElement | ((props, state) => ReactElement)—Replace the rendered element while keeping behavior and accessibility wiring.

EmptyContent

PropTypeDefaultDescription
childrenReactNode—Content for this semantic empty-state part.
renderReactElement | ((props, state) => ReactElement)—Replace the rendered element while keeping behavior and accessibility wiring.

Keyboard

KeyAction

Accessibility

Static section with heading, description, and optional content. It does not announce as status or alert; keep the empty state understandable in visible text and use a native link or button for its next step.

Styling hooks

data-uiify-emptydata-uiify-empty-titledata-uiify-empty-descriptiondata-uiify-empty-contentdata-part