Empty state

Last modified by Thiago Krieck on 2026/11/18 14:13

Warning
Draft

This page is a draft. The standards on it are proposals still under discussion, so they may change and should not be treated as final yet.

The standard

When a list, tab, table or panel has nothing to show, it should say so in place, so that users can tell "empty" from "still loading" or "broken" and know what to do next.

  • What's empty: The message should name what is missing, in the user's words, such as No comments for this page. A generic No entries should only be used when nothing more specific is known.
  • Why: When the reason isn't obvious, the message should give it in a few words, as Administration → Import does with No pages found in the selected archive, so that users don't think the content is gone.
  • Next step: The action that fills the region should stay right below the message (Add comment, Attach, Create page), or a way out should be offered, such as a link that removes the active filters, so that the empty state isn't a dead end. Actions should only be shown to users who have the rights to use them.
  • Style: Should be short muted text (.noitems, or the LiveData bottom bar text) in place of the content, never an alert box, since an empty list is not a warning or an error.
  • Tone and punctuation: Should be neutral and plain: no exclamation marks, parentheses or quotes. A single phrase takes no final period; a message with a second sentence uses periods.

Reference example: the Comments tab of a page with no comments. It shows No comments for this page as muted text where the comments would be, and the Add comment button right below it for users who can comment.

empty-reference-comments.png

Empty state: the Comments tab of a page with no comments

Notes

  • A message that appears after loading or filtering (LiveData, notifications) should be in a polite live region (aria-live="polite"), so that screen reader users hear that nothing was found. See Accessibility.
  • Button and link labels in the empty state follow Action labels.

More

Get Connected