Generic selectors

Exact matches only

Search in title

Search in content

Post Type Selectors

Empty State

Empty States signify a condition in which there is no content to display or, alternatively, convey a message intended to inform the user.

  • Overview
  • Specs
  • Guidelines

Pattern

This design pattern serves to represent a state within an interface where no content is currently available for display. It is often utilized to indicate to users that there is no data or information to present at the moment.

This deliberate absence of content serves as a visual cue, prompting users to take appropriate actions, such as initiating a search, creating new content, or navigating to alternative sections within the application.

By incorporating the Empty State pattern into the design system, we ensure a consistent and intuitive user experience when faced with these scenarios in various interfaces and applications..

empty_state_anatomy
Empty State anatomy

1: Accent Icon

2: Title

3: Description

4: Button

Graph - Empty State
Empty State applied in Dashboard

Used for:

No data to show

When there is no data to show in a table or chart, an Empty State is used to inform the user. There is also a possibility to show a button;

No permissions

When a user doesn’t have permissions to access a certain file or page/view, an Empty State is displayed where the user can request access;

Areas under maintenance

When some view or area on the application is under maintenance, we must inform the users, using an Empty State;

Loading failed

When for some reason the page/view or modal/flyout has failed to be loaded, an Empty State will be displayed with a button to reload the content;

Don’t use for:

Page error

When the whole page has an error such as a 404 error, another template is used which is the page error pattern;

Contextual irrelevance

If the absence of content doesn’t occur naturally within the user flow or doesn’t serve a meaningful purpose, implementing an Empty State might confuse users rather than helping them;

Unnecessary interruption

In some cases, interrupting the user experience with an Empty State may not be necessary, especially if users are engaged in a task where the absence of content is expected or inconsequential;

Limited screen space

In interfaces with limited screen space, such as mobile applications, prioritizing the display of content over Empty States may be more beneficial to optimize the user experience.

404_EmptyState
Empty state applied as a 404 error

Demo

Access the Figma file and inspect the element using Dev Mode.

playgorund_empty_state
Empty State in figma

Last Update

Empty State_Before
Old version of the Empty State
Empty State_Current
Current version of the Empty State
  • Updated pictograms to accent icons;
  • Updated buttons;
  • Updated color variables;

Related

Accent Icons

Accent Icons in UX serve as graphical representations of concepts, actions, or objects, enhancing user understanding and interaction within digital …

Data Grid

Data Grids are used to efficiently organize information and make it easier for users to consult it …

Variations

EmptyState
Empty State
With Button
.WithButton {n  title: var(u002du002dsubtitle-1,u002du002dgrey-9);n  description: var(u002du002dbody-2,u002du002dgrey-8);n  button: var(u002du002dprimary-theme-regular);n}
Without Button
.WithoutButton {n  title: var(u002du002dsubtitle-1,u002du002dgrey-9);n  description: var(u002du002dbody-2,u002du002dgrey-8);n}

Size

Unique Size
.UniqueSize {
  accentIcon: 144px;
  gapTop: var(--spacing-8);
  gap: var(--spacing-16);
}

Useful links

guidelines figma accent icon

Consult our Figma file to access our assets and inspect them in dev mode.

polygon-framework

This component is or will be provided by the Polygon framework. See its documentation to learn more.

This element is in line with the guidelines of the CDS (Cegid Design System). Find out more.

Behavior

Alignment

In order to improve readability and comprehension of the written content, the Empty State pattern should always be center aligned. Users can quickly and easily understand the message being conveyed without having to scan across the screen, which could be the case if the content was aligned to the left or right.

Center alignment creates a sense of balance and symmetry in the design as well. This can make the Empty State feel intentional and integrated with the overall design aesthetic, rather than looking like an afterthought.

EmptyState_Charts
Empty State applied to charts

Usage

Elements

The Empty State pattern consists of essential and optional elements that provide clarity and usability. While some elements are required to ensure consistency, others are secondary and should only be included when they add value to the experience.

Required Elements

Accent Icon: a visual indicator that helps users quickly recognize the empty state. It reinforces the message and ensures clarity.

Title: a concise text that communicates the empty state clearly, ensuring users understand why no data is displayed. When a title is a description, the text should follow the capitalization guidelines.

Empty State - only required elements applied in dashboards
Empty State – only required elements applied to dashboards

Secondary Elements

Description: additional text that provides context or guidance, helping users understand what actions they can take next. It should only be included if necessary.

Button: an actionable element that allows users to respond to the Empty State, such as adding new data or adjusting filters. It should only be used when a clear next step is available.

Empty State applied in flyout with all elements
Empty State applied to a flyout with all elements

The description should not exceed two lines.

Application

When to Add Actions

If it is possible to create a new entry in the dedicated area (dashboards cannot have such a button, for example, because it is an area for viewing data rather than creating or editing);


If there is a clear next step for the user, since an Empty State represents an opportunity for the user to add new data to the datagrid, for example;

Empty State - No results found
‘No results found’ Empty State

Choosing a Button Variation

1. Primary

If there aren’t any other primary actions on the page, and this is going to be the primary one, the primary variation should be used;


Primary button applied in empty state of AI flyout
Primary button applied to the AI Flyout Empty Etate
2. Secondary

If the action is the same as the main action of the page, or if the action is simply secondary (e.g., Reset Filters);


Secondary button applied to a Datagrid Empty State

If there are multiple Empty States on the same page, use the secondary button instead of the primary button;

3. Tertiary

If the action is part of an optional field (e.g., Thumbnail, Image & File Uploader);

Tertiary button applied in Thumbnail empty state
Tertiary button applied in Thumbnail Empty State

Apply the Text Button variation to the Empty State pattern.


Case Studies

Why Web Accessibility Matters - And How to Start

Why Web Accessibility Matters – And How to Start

Web accessibility is about designing inclusive digital experiences that benefit everyone, guided by four key principles and driven by the …
Writing for Everyone

Writing for Everyone: Every Word Counts in Accessibility

Writing for everyone is an essential part of any digital product. It can and does make a big difference to …

Release v1.4

Overview Compose Design has recently undergone some important updates, which means it’s time for another release note. In addition to …

Outline