# Loading, empty and error states

> Each state has a different reason and a different next step. Write them deliberately.

| State | Say | Offer |
| --- | --- | --- |
| Loading (under 300 ms) | Nothing; show the content when ready | – |
| Loading (longer) | A skeleton shaped like the content, or a spinner with what is loading | Cancel, if it is long |
| No data yet | What will appear here | The action that creates the first item |
| No results | Which filter excluded everything | Clear the filter |
| No permission | Who can grant access | Request access |
| Error | What failed, in plain words; whether data was lost | Retry; a way to report it |
| Partial | What loaded and what did not | Retry the failed part |

Never show raw error codes or stack traces as the message. Never fake progress: use an indeterminate indicator when the duration is unknown.
