On September 25th, 2024, we released v2 of the Apps SDK. To learn what’s new and how to upgrade, see Migration FAQ and Migration guide.
Design guidelines
Fundamentals
Empty states help communicate that an app has no content to show, but also what kind of content a user should expect to see on the page.
An excellent empty state or page uses this opportunity to build trust, or provide suggestions that help users fix or continue their task.
Empty states are crucial when designing apps that use authentication or fetch, because some authenticated users may not have any content or data associated with their accounts.
A Headline stating what’s empty.
B Body informs what’s needed to fill the page. Keep the message concise, informative, and actionable, using 1-2 sentences.
C One primary call to action button.
Do
- Center the content.
- Use Title/Small for the headline and Body/Small for the body.
- Use
colorTypographyPrimary
for the headline andcolorTypographyPrimary
for the body. - Spacing should be 8px/1u between headline and body, 16px/2u between body and primary button.
- Use a primary button for any action, including opening an external link.
Don't
- Add illustrations or graphics.
- Use other typography styles for the headline.
- Use a link button for the primary action.