Components/Layout
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/emptystate
An empty state is used when an app, page or section has no data to show.
<MarketingPageLayout/> or <MarketingLayout/> instead.An empty state has 4 optional elements:
imagetitlesubtitlechild container, which can hold any component but is primarily reserved for CTA buttons.align controls how all EmptyState content (title, subtitle, image, and actions) is aligned inside its container.
align="start": aligns content to the start (left in LTR)align="center": centers content (default)align="end": aligns content to the end (right in LTR)Control an empty state's appearance with the skin property. There are 3 types:
page is for full-page empty states where data is displayed in a full-width table or a card.page-no-border is for full-page empty states where data is displayed in an unknown layout.section is the default theme for layout elements such as cards, tables or modals.Add 1 or more CTA buttons below the subtitle as child elements of the empty state.
Be sure to give the user clear next actions.
Use the page or page-no-border skin to tell users what will appear on the page once there's data to display, and if relevant, what they can do to get started.
Use the section skin empty state to tell users what will appear on the card once there's data to display and, if relevant, what they can do to get started.
Keep the design minimal and avoid using illustrations.
Use an empty state when a search doesn't return any results. Explain what happened and what users can do next to adjust their search.
Let users know that their data failed to load. If possible, provide a next action.
Use an empty state in the main tab of the app settings panel to give a brief introduction to the app.
Place the app icon and a short description at the top, and provide main actions to help users get started using the app.
| Name | Type | Default | Description |
|---|---|---|---|
align | "center" | "end" | "start" | 'center' | Sets the alignment of all empty state contents within the component container. |
children | ReactNode | — | Contains components rendered below the subtitle, e.g., <Button/> or <TextButton/> |
classNames | { imageContainer?: string | undefined; } | — | Sets the empty state image bottom margin. If not specified, use the default padding defined in the CSS. |
dataHook | string | — | Applies a data-hook HTML attribute to be used in the tests. |
image | string | ReactElement | null | — | Contains the empty state image. Can be either a string representing the image URL, or a node to render. |
skin | "section" | "page" | "page-no-border" | 'section' | Sets the style skin for the empty state. |
subtitle | ReactNode | — | Sets the content for the subtitle. |
theme | "section" | "page" | "page-no-border" | — | Sets the style skin for the empty state. Used only when skin isn't set. |
title | ReactNode | — | Sets the content for the title. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
element | Returns the element |
getTitleText | Returns the text of the title |
getSubtitleText | Returns the text of the subtitle |
hasTheme | Returns true if the component was configured with given skin |
hasSkin | Returns true if the component was configured with given skin |
getImageUrl | Returns the URL of the image element (if persist) |
getImageContainerClassName | — |
imageNodeExists | Returns true if a node passed via the image prop exists |
childrenContentExists | Returns true if children content exists |
hasAlign | Returns true if the component was configured with given align |
exists | Checks whether the component found with the given data hook. |
click | Clicks on the component root element. |
base | Returns UniDriver for the base element. |
Last updated: 22 October 2026