# Empty State

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

### What are Empty States?

Empty states appear in a view when:

* No records match the view 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

<figure><img src="https://319575345-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifpIQWu0HCVYAt51oT%2Fuploads%2Fgit-blob-5129bb8a86a7cc6252a00b1e7dcd635424edd680%2Fimage.png?alt=media" alt=""><figcaption><p>Empty state on a View</p></figcaption></figure>

### How to Customize a View Empty State

1. Navigate to the view, either a [List component](https://guides.noloco.io/components#supported-components) or a [view](https://guides.noloco.io/pages/views)
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](https://undraw.co/illustrations)

{% @arcade/embed url="<https://app.arcade.software/share/2lRklBXRWbZTPcRXqZ18>" flowId="Qz28xM1ZAJIQJcvYkWHL" %}

### Hide a List Component if no Records Exists

If you're using a List component on a [Record Page](https://guides.noloco.io/data-to-app#row-record-page) or [Blank Page](https://guides.noloco.io/pages/blank-pages) 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 List such that no records are displayed, the Empty State will be shown, the component won't be hidden.

<figure><img src="https://319575345-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifpIQWu0HCVYAt51oT%2Fuploads%2Fgit-blob-27c8a2852237078b6b6567ab87af22198881aae3%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
