Overview Button Copy button Field Input Number field Textarea Select Combobox Multiselect Date picker Date range picker Date-time picker Checkbox Radio group Position picker Switch Slider Dropzone Device controls Avatar Badge Card Collapsible Kbd Map Matrix Proportion bar Separator Stat Table Timeline Chat Playback Pagination Charts Chart theming Profile chart Time series chart Bar chart Isopleth chart TS diagram Box plot Rose chart Calendar chart Banner Toast Loader Progress Skeleton Empty state Error state Dropdown menu Tooltip Info tooltip Dialog Sheet Resizable Confirm dialog Breadcrumbs Command palette Mobile menu Navigation list Outline Scroll rail Sidebar Tabs
Empty state
Nothing to show, said in a way that leads somewhere: what would be here, why it isn’t, and the one action that puts something here.
Plain
On the page, centred in the region that's empty.
No missions yet
Missions are the days out on the water. Plan the first one to book a vessel.
<EmptyState
icon="route"
title="No missions yet"
description="Missions are the days out on the water. Plan the first one to book a vessel."
>
<Button variant="primary" iconLeft="plus">Plan mission</Button>
</EmptyState> Inset
In a dashed frame, for an empty slot among filled ones, like a panel beside a full one.
CTD profiles
6 waypoints, 3 038 samples
No lab results
They arrive here once the lab has analysed the samples.
Over a table
The table it will be, faded into the page, with the message laid over it. The header stays real.
No missions match
Nothing scheduled in April for Starefoss ledning.
<TablePlaceholder state="empty" cells={['text', 'muted', 'badge']} {head}>
<EmptyState icon="magnifying-glass" title="No missions match" description="…">
<Button onclick={clearFilters}>Clear filters</Button>
</EmptyState>
</TablePlaceholder> What to say
Nothing yet What would be here and the action that creates the first one. The most useful empty state there is: it’s where someone starts.
Nothing matches That a filter or search hid everything, and a button that clears it. Keep the filters in view so they can be changed.
All done That the list emptied because the work is done: no flags left, nothing to review. A plain statement, no action needed.
Not for you That the data exists but this role can’t see it, and who to ask. Not dressed up as empty.
Rules
- A statement for the title, not a question or a joke: “No missions yet”, “No rows match”.
- One or two sentences for why and what changes it. Skip it when the title says it all.
- One action, two at most. The primary one only when creating the first thing is the obvious next step.
- An icon for the thing that’s missing, not a generic “empty box”.
- For a table, lay it over a faded TablePlaceholder: the columns it will have are already in view, and the page doesn’t jump when the first row appears.
- Never instead of an error. A failed load says it failed and offers a retry.