Page

Components/Layout/Page

Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/page

Overview

Copy

Use the page component to build the structure of each page. It's designed for Business Manager applications but can be customized for other use cases too.

Do

  • Use it to build all standard Business Manager pages.
  • Customize it as you need for other use cases.

Don't

  • Don't use it to build marketing pages. Use dedicated <MarketingPageLayout/> instead.

Feature examples

Structure

This component consists of <Page.Header/> and <Page.Content/> areas. Both are mandatory in the Business Manager page layout.

Copy

Height

Set page height using viewport height unit (vh). By default, page height should equal 100vh (full screen size). If the page has a Business Manager top bar navigation, set the page height to calc(100vh-48px).

Copy

Width

Add constraints to content width with the following props:

  • minWidth specifies the minimum content width.
  • maxWidth specifies the maximum content width. When the limit is reached, the side margins stretch and the content aligns to the center of the page.

By default, the page minimum width is 864px and the maximum width is 1248px (plus 48px padding on the sides). These values should be used across all Business Manager pages but can be changed for other use cases.

Copy

Side padding

Control left and right content padding with the sidePadding prop. The default value is 48px and should be used across all Business Manager pages. The default padding can be changed for other use cases.

Copy

Background image

Add a background image to the page header with backgroundImageUrl prop. Use it to showcase things like services, products or other items you want to feature.

Copy

The <Page.Header/> sticks to the top of the page and minimizes when visitors scroll down. This default behavior can't be changed.

Copy

Horizontal scroll

Enable horizontal scroll with the horizontalScroll prop.

When visitors scroll, the <Page.Header/> stays fixed. Use it when the width of content exceeds the maximum page width. For example, when displaying wide tables or lists.

Copy

Header tail

Pin content below the header by wrapping it into a <Page.Tail/> container. Use it for content that needs to be visible at all times, for example a table header in an infinite scroll table.

Copy

Sticky areas

Wrap page sections into <Page.Sticky/> containers to keep a section fixed in position while visitors scroll.

Copy

Create anchor links that direct visitors to a place inside the page using references (ref) and onClick events.

Copy

Common use case examples

Empty state

When there's no data to display on a page, use an <EmptyState/> with a clear call to action that tells visitors what they should do next.

Copy

Tabs

<Tabs/> can be used to show more content with the same hierarchy level on the same page. Use <Page.Tail/> to fix tabs below the page header so visitors can navigate between content.

Copy

Form layout: full width

Make sure the form page has "Save" and "Cancel" both at the top and the bottom of the page. Use <Page.Footer/> container to store actions at the end of a form.

Copy

Form layout: two-thirds

For form page layouts, use an 8 column layout and keep 4 columns blank. This makes it easier to scan.

Copy

Form layout: two-thirds with a sidebar column

Use a <Layout/> grid to construct a ⅔ form layout that exposes primary and secondary content at the same time. To fix the sidebar's position while scrolling through the main page content, use <Page.Sticky/>.

Copy

Table

Use <Page.Sticky/> to fix the position of the content to a specific part of the page. For example, fixing the column titles of a table so visitors can sort and filter easily.

Copy

2 column list

Use a 2-column page layout to list features, tools or products. This layout works well for items that have relatively long titles and descriptions.

Copy

4 column list

Use a grid page layout with 4 columns to display visual items like, menus, categories, collections and photo albums.

Copy

Dashboard

Use a combination of different grids within the same page. This is a great way to display different types of content on one page. Use <Page.Section/> to divide content into groups.

Copy

Code

Copy

Props

NameTypeDefaultDescription
backgroundImageUrlstring—Provides a link to the background image source (URL). The image is displayed at the top of the page, underneath the <Page.Header/>.
childrenReactNode—Accepts compound components as child items: - <Page.Header/> - <Page.Content/> - <Page.Tail/> - <Page.Section/> - <Page.Footer/>
dataHookstring—Applies a data-hook HTML attribute that can be used in the tests.
gradientClassNamestring—Specifies a CSS class name that defines a gradient background for <Page.Header/>.
heightstring—Sets the height of the page in pixels (px), viewport height (vh), etc.
horizontalScrollboolean—Enables page content to scroll horizontally when its width exceed maximum allowed width.
maxWidth (required)number—Sets the maximum width of the page (paddings excluded)
minWidthnumber—Sets the minimum width of the page (paddings excluded). When mobile is enabled on <WixDesignSystemProvider/>, the default minimum width is removed, but an explicitly provided value is still applied.
scrollableContentRef(ref: HTMLElement | null) => void—Defines a reference called together with page scrollable content ref after page mount.
Note - if you need this ref only for listening to scroll events on the scrollable content then use this prop instead: scrollProps = {onScrollChanged/onScrollAreaChanged}
scrollProps (required)ScrollableContainerCommonProps—Pass properties related to the scrollable content of the page.
onScrollAreaChanged - defines a handler function for scroll area changes. Function is triggered when the user scrolls to a different area of the scrollable content. See signature for possible areas: function({area: {y: AreaY, x: AreaX}, target: HTMLElement}) => void AreaY: top | middle | bottom | none AreaX: start | middle | end | none (not implemented yet)
onScrollAreaChanged - defines a general handler for scroll changes with throttling (100ms): function({target: HTMLElement}) => void
sidePaddingnumber—Sets the side paddings of a page. Also applies when <Page.Content/> is fullScreen.
verticalPaddingnumber—Sets the top and bottom paddings of the page content in pixels. The top padding applies only when the page has no <Page.Header/> or <Page.Tail/>, and the bottom padding only when it has no <Page.FixedFooter/>. When not set, the content has no top padding and a 48px bottom padding.
zIndexnumber—Specifies the stack order (z-index) of a page.

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
hasClass—
scrollableContainerProvides a UniDriver for the page's scrollable container.
backgroundImageExiststrue if header background image exist
gradientClassNameExiststrue if gradient class name exist
tailExiststrue if tail exist in DOM
gradientContainerHeightreturn container height
getPageHtmlreturns html in a string form
existsChecks whether the component found with the given data hook.
elementGets the component root element.
clickClicks on the component root element.
baseReturns UniDriver for the base element.

Changelog

  • 1.341.0 (2026-10-22) — maintenance release, no component-specific changes
  • 1.340.0 (2026-10-21) — maintenance release, no component-specific changes
  • 1.339.0 (2026-10-19) — maintenance release, no component-specific changes
  • 1.338.0 (2026-10-15) — maintenance release, no component-specific changes
  • 1.337.0 (2026-10-14) — feat: add a scrollableContainer property to the UniDriver so tests can access the page's scrollable content. (#17444)
  • 1.336.0 (2026-10-13) — maintenance release, no component-specific changes
  • 1.332.0 (2026-10-05) — feat: add stretchVertically to Page.Content, so content such as a <Card stretchVertically/> can fill the page's visible height, and a verticalPadding prop to set the content's top and bottom padding. A sidePadding set on Page now also applies to fullScreen content, which previously dropped it. (#17337) — has visual changes
  • 1.331.0 (2026-10-01) — maintenance release, no component-specific changes
  • 1.330.3 (2026-09-29) — maintenance release, no component-specific changes
  • 1.330.0 (2026-09-28) — maintenance release, no component-specific changes
  • 1.329.0 (2026-09-24) — maintenance release, no component-specific changes
  • 1.328.0 (2026-09-22) — maintenance release, no component-specific changes
  • 1.325.0 (2026-09-17) — maintenance release, no component-specific changes
  • 1.320.0 (2026-09-03) — fix: the page background changed from #F8F6F6 to #F7F7F7 in Harmony (odeditor). (#16941)
  • 1.317.0 (2026-08-26) — fix: the content area now shows the standard WDS scrollbar. (#16867)
  • 1.312.0 (2026-08-14) — maintenance release, no component-specific changes
  • 1.310.0 (2026-08-10) — maintenance release, no component-specific changes
  • 1.307.0 (2026-08-03) — maintenance release, no component-specific changes
  • 1.306.0 (2026-07-31) — maintenance release, no component-specific changes
  • 1.305.1 (2026-07-30) — maintenance release, no component-specific changes
  • 1.299.0 (2026-07-17) — maintenance release, no component-specific changes
  • 1.295.0 (2026-07-03) — maintenance release, no component-specific changes
  • 1.292.0 (2026-06-22) — maintenance release, no component-specific changes
  • 1.291.0 (2026-06-19) — maintenance release, no component-specific changes
  • 1.289.0 (2026-06-17) — fix: footer divider hidden in harmony theme (#16394) — has visual changes
  • 1.285.0 (2026-06-05) — feat: adapt layout when WixDesignSystemProvider is in mobile mode (#16338) — has visual changes
  • 1.281.0 (2026-05-19) — fix: replace settimeout hack with resizeobserver for header height (#16293)
  • 1.278.0 (2026-05-08) — maintenance release, no component-specific changes
  • 1.273.0 (2026-04-30) — maintenance release, no component-specific changes
  • 1.272.0 (2026-04-27) — maintenance release, no component-specific changes
  • 1.266.0 (2026-04-07) — maintenance release, no component-specific changes
  • 1.260.0 (2026-03-17) — maintenance release, no component-specific changes
  • 1.258.0 (2026-02-23) — breaking: tokenization + update of update-screenshots script (#15936)
  • 1.256.2 (2026-02-13) — fix: default minWidth is reverted to 960px (#15920)
  • 1.256.1 (2026-02-10) — maintenance release, no component-specific changes
  • 1.254.0 (2026-02-03) — maintenance release, no component-specific changes
  • 1.252.0 (2026-01-28) — feat: add media query + decrease min-width (#15873)
  • 1.247.2 (2026-01-21) — maintenance release, no component-specific changes
  • 1.241.0 (2025-12-17) — maintenance release, no component-specific changes
  • 1.240.0 (2025-12-16) — maintenance release, no component-specific changes
  • 1.238.0 (2025-12-10) — maintenance release, no component-specific changes
  • 1.213.0 (2025-08-19) — maintenance release, no component-specific changes
  • 1.197.0 (2025-06-06) — maintenance release, no component-specific changes
  • 1.155.0 (2025-01-23) — maintenance release, no component-specific changes
  • 1.154.0 (2025-01-17) — maintenance release, no component-specific changes
  • 1.144.0 (2024-12-03) — maintenance release, no component-specific changes
  • 1.143.0 (2024-11-25) — maintenance release, no component-specific changes
  • 1.138.1 (2024-10-30) — maintenance release, no component-specific changes
  • 1.123.1 (2024-09-05) — maintenance release, no component-specific changes
  • 1.115.0 (2024-07-17) — maintenance release, no component-specific changes
  • 1.107.0 (2024-05-29) — maintenance release, no component-specific changes
  • 1.104.1 (2024-05-14) — maintenance release, no component-specific changes
  • 1.102.0 (2024-04-16) — maintenance release, no component-specific changes
  • 1.98.0 (2024-03-15) — fix: fix minWidth prop (#13459)
  • 1.97.2 (2024-03-04) — feat: add usePageContext Support (#13398)
  • 1.97.1 (2024-02-28) — breaking: tokenise (#13375)
  • 1.97.0 (2024-02-26) — maintenance release, no component-specific changes
  • 1.96.0 (2024-02-21) — maintenance release, no component-specific changes
  • 1.93.1 (2024-02-12) — maintenance release, no component-specific changes
  • 1.93.0 (2024-02-08) — maintenance release, no component-specific changes
  • 1.92.1 (2024-02-05) — maintenance release, no component-specific changes

Last updated: 26 October 2026

Did this help?