Empty State

Customizing your collection empty states to for a tailored app experience

Empty states in collections (tables, boards, charts, lists, etc.) occur when no records or rows match a collection's filters or a user's permissions.

What are Empty States?

Empty states appear in a collection when:

  • No records match the collection filters, or filter fields

  • No records match the user's permissions

Customizing these states is a great way to give your users context on what to expect when there are nor matching records, and to make your app feel more intuitive.

Importance of Customizing Empty States

Custom empty states provide clarity to users, explaining why no data is present and what actions they can take. It’s an opportunity to:

  • Guide users on next steps, such as creating a new record.

  • Maintain engagement.

  • Improve branding and tone of the app

How to Customize a Collection Empty State

  1. Navigate to the collection, either a collection component or a collection view

  2. Open the Empty State settings in the configuration panel

  3. Customize the Empty State message Explain why no records are shown, suggest an action they can take

  4. Add an optional image Choose an image that aligns with your message and brand. We reccomend browsing something like undraw.co

Hide a Collection Component if no Records Exists

If you're using a collection component on a Record Page or Blank Page you can hide the whole component if no records exist. This can be very helpful for tidying up the page, if there are no linked records to show. Note: If records do show by default, but the user filters the collection such that no records are displayed, the Empty State will be shown, the component won't be hidden.

Last updated