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.