On this page
@addTagHelper *, Webority.Ui.RazorParts
Give the empty state a title, guidance and one action, so the user can act without hunting for a button.
Sizes
Use md for a page or card, and sm for a tighter widget or tile where the md title would feel oversized.
Table body
Use the table variant for the empty body of a data table, so the empty message sits where the rows would be.
Illustrations
Pick a named drawing for a first-run, search or error moment; the title carries the meaning, not the picture.
Your own drawing
Use your own decorative drawing when no named one fits; it is drawn unboxed at up to 120 pixels.
Every option
Every value of every prop, one cell each.
icon
icon="folder-open"icon="search"no iconillustration
illustration unset (default)illustration="no-results"illustration="no-data"illustration="empty-inbox"illustration="no-notifications"illustration="no-files"illustration="no-access"illustration="offline"illustration="error"illustration=<svg> (app-empty-illustration child)iconSize
icon-size="24" (default)icon-size="48"size
size="md" (default)size="sm"variant
variant="card" (default)variant="table"title
title="Nothing here yet"title="0"description
description unset (default)description="Try a broader keyword."description: long text wrapsaction
action unset (default)(content): app-button childclassName
class unset (default)class="mt-4"style
style unset (default)style="opacity: 0.5"Guidance
What to do, and what to avoid.
Use it when
- A card or section has loaded but there is genuinely nothing to show.
- A first-run experience where the user hasn't created anything yet.
- A filtered or searched view returned no matches and you want to explain why.
- A data table has loaded with no rows: use variant="table" for the table body.
Reach for something else when
- The data is still loading (first fetch). → AppSkeleton
- Something went wrong fetching the data. → AppAlert
- You just need a one-line "nothing here" with no framing. → a muted caption
Offer a next step
Names what's missing, explains why it matters, and offers the exact action to fix it.
A bare "Empty" with no guidance and no action leaves the user stuck at a dead end.
Explain a search with no matches
A search-empty explains the specific query and suggests how to get results.
A bare "No results" with no reason and no way forward leaves the user unsure whether to change the search or the data.
Keep the description specific
A description that says what the empty state means helps the user, where filler only pads the space.
Repetitive filler text pads the space without helping the user do anything.
Reference
Try every prop, read the full list, and check keyboard and screen reader behaviour.
8 props. The 5 most used come first.
Used on most screens 5 props
| Prop | Type | Default | Description |
|---|---|---|---|
| icondefault - | string | - | Semantic icon name for the bubble. Needed unless illustration is set, which replaces the bubble. |
| sizedefault md | md | sm | md | The type scale: md is the page or card empty state, sm is the tighter widget or tile variant with a smaller title and text. |
| variantdefault card | card | table | card | The look: card is the card or section empty state; table is the body of a data table, with a larger disc above the title. The table look has no sm scale, so size sm with table adds both classes. |
| titledefault - | string | - | The heading: name what's missing. |
| descriptiondefault - | string | - | Supporting line of guidance below the title. |
Less common 3 props
| Prop | Type | Default | Description |
|---|---|---|---|
| illustrationdefault - | no-results | no-data | empty-inbox | no-notifications | no-files | no-access | offline | error | - | Decorative drawing by name, in theme colours that follow dark mode. Replaces the icon bubble when set. |
| icon-sizedefault 24 | int | 24 | Size of the icon in the bubble, in pixels. |
| (content)default - | markup | - | Inner content renders as the action slot, usually the next-step app-button. |
Screen reader
3 notes- A named illustration is decorative; the title carries the meaning for assistive technology.
- A custom illustration node is wrapped with aria-hidden, so it is skipped by screen readers.
- The title and text are plain text blocks, read in order with the action last.
Do and avoid
3 pairsOffer a next step
Names what's missing, explains why it matters, and offers the exact action to fix it.
A bare "Empty" with no guidance and no action leaves the user stuck at a dead end.
Explain a search with no matches
A search-empty explains the specific query and suggests how to get results.
A bare "No results" with no reason and no way forward leaves the user unsure whether to change the search or the data.
Keep the description specific
A description that says what the empty state means helps the user, where filler only pads the space.
Repetitive filler text pads the space without helping the user do anything.