Skip to main content

Empty State
ready
Storybook

Available from v11.0.0

An empty state consists of a message and optionally an image, button, and additional information.

When to use​

Use an empty state to communicate to the user that there is no data to display and provide instructions for what to do next. Example use cases:

  • When a user has not created a particular resource yet
  • When a filter or search query returns no results
  • When a user completes all actions, such as clearing their inbox or notifications

There is an EmptyState component with different variants to handle the most common empty state use cases. These variants provide a sensible default image.

Usage​

variant="call-to-action"​

Use when there is no data to display and you want to encourage the user to take an action. Usually either to complete some initial configuration, or to create an item.

import { EmptyState, LinkButton, TextLink } from '@grafana/ui';

<EmptyState
  variant="call-to-action"
  message="You haven't created any playlists yet"
  button={
    <LinkButton icon="plus" href="playlists/new" size="lg">
      Create playlist
    </LinkButton>
  }
>
  You can use playlists to cycle dashboards on TVs without user control.{' '}
  <TextLink external href="<externalDocsLink>">
    Learn more.
  </TextLink>
</EmptyState>;

For scenarios where there is no single button that can be clicked to create the item, you can omit the button prop. Instead, provide additional information to help the user understand how to create the specific resource.

import { EmptyState, TextLink } from '@grafana/ui';

<EmptyState variant="call-to-action" message="You haven't created any library panels yet">
  Create a library panel from any existing dashboard panel through the panel context menu.{' '}
  <TextLink external href="<externalDocsLink>">
    Learn more.
  </TextLink>
</EmptyState>;

variant="not-found"​

Use in place of content when a search query or filter returns no results.

There are sensible defaults for the image, so in most cases all you need to provide is a message.

import { EmptyState } from '@grafana/ui';

<EmptyState variant="not-found" message="No playlists found" />

variant="completed"​

For when a user has completed all tasks on a page, such as reading all their notifications.

import { EmptyState } from '@grafana/ui';

<EmptyState variant="completed" message="You're all caught up" />;

Customization​

For all variants you can:

  • provide a custom image or hide the image entirely
  • provide a button (e.g. to provide a call to action or clear the search query)
  • provide additional information via React children
import { Button, EmptyState, TextLink } from '@grafana/ui';

<EmptyState
  button={<Button variant="secondary" onClick={clearSearchQuery} />}
  image={<AnyReactNode />}
  message="No playlists found"
  variant="not-found"
>
  Optionally provide some additional information here. Maybe even a link to{' '}
  <TextLink href="<externalDocsLink>" external>
    documentation.
  </TextLink>
</EmptyState>

Playground​