Components/Layout/Page
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/page-header
The page header appears at the top of a page, orients the user and focuses their attention on the primary action to be taken.
<Page/> component.<Page/> component.<PageSection/> instead.<Heading/> instead.Page header structures can vary, but they can include up to three elements:
titlesubtitle (optional)actionBar (optional)Place page actions on the right side of the header using the actionsBar prop.
Pages should only have one primary action. If more actions are needed, place them in a "More Actions" popover menu, which can be displayed from a <Button/> or <IconButton/>.
Display the path to this page with breadcrumbs, which let users navigate back to previous pages quickly.
The showBackButton prop lets users navigate to the previous page in the site hierarchy. The back button should only be used when there are breadcrumbs.
Invert the header styles with the hasBackgroundImage prop when using an image or dark-colored background.
This property only affects the styles of the title, subtitle, breadcrumbs and back button. Button styles must be changed manually.
Let users edit the page title by rendering <EditableTitle/> as the title prop value.
The page title is limited to a single line of text. The subtitle has a limit of 2 lines.
Longer values will be truncated with ellipses and the full text will be displayed in a tooltip on hover.
Note: Keeping all title text visible on the screen at all times is very important for accessibility and usability overall. Keep page titles short.
The page header minimizes automatically on scroll. You can also choose to use the minimized header manually with the minimized prop. The minimized version is displayed on top of the page content when users scroll down.
Breadcrumbs show in a minimized header instead of the page title when they're on a page.
Add links to external resources that explain products or features in more detail by using inline <Box/> within the subtitle.
If <Page/> has a background image the <Page.Header/> style will automatically be inverted. Make sure to adjust button styles manually.
| Name | Type | Default | Description |
|---|---|---|---|
actionsBar | ReactNode | ActionsBarRenderFn | — | Adds an empty container on the right side of a header. Most commonly used to store primary and secondary actions of a page, but can contain any other element, i.e. dropdown selection. It receives minimized and hasBackgroundImage props. |
backButtonAriaLabel | string | — | Defines a string value that labels the back button element. |
breadcrumbs | ReactNode | BreadcrumbsRenderFn | — | Adds an empty container above the page title. It accepts any item as a child element, but should be used to pass <Breadcrumbs/> component only. For any custom enquiries, contact the Wix Design System team first. |
dataHook | string | — | Applies a data-hook HTML attribute that can be used in the tests. |
hasBackgroundImage | boolean | — | Inverts header styles. This property is supplied by <Page/> component and reflects whether <Page/> has a background image or not. |
minimized (required) | boolean | — | Changes header appearance to a denser version. Value changes by the state of the scrolled content inside of a <Page/>. |
onBackClicked | MouseEventHandler | — | Defines a callback function which is called every time a back button is clicked. |
showBackButton | boolean | — | Specifies whether the back button is visible. |
skin | "light" | "dark" | — | Controls header skin (light or dark) |
subtitle | ReactNode | — | Specifies page subtitle text. |
title | ReactNode | TitleRenderFn | — | Specifies page title text. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
hasClass | Checks whether the PageHeader class exists |
titleText | Gets PageHeader title text |
isTitleExists | Checks whether the PageHeader title exists |
subtitleText | Gets PageHeader subtitle text |
isSubtitleExists | Checks whether the PageHeader subtitle exists |
isBreadcrumbsExists | Checks whether the PageHeader breadcrumbs exists |
breadcrumbsText | Gets PageHeader breadcrumbs text |
isActionBarExists | Checks whether the PageHeader action bar exists |
isBackButtonExists | Checks whether the PageHeader back button exists |
clickBackButton | Clicks PageHeader back button |
exists | Checks whether the component found with the given data hook. |
element | Gets the component root element. |
click | Clicks on the component root element. |
base | Returns UniDriver for the base element. |
#151414 to #525150 (odeditor) and from #FFFFFF to #A8A6A5 (odeditor-dark), and the selected crumb renders at weight 500 per spec (unchanged in odeditor, changed from 700 in odeditor-dark); the subtitle gets a 4px gap below the title and 4px start padding; the EditableTitle text-to-marker gap changed from 6px to 4px. All other themes render unchanged. (#16681)--wds-page-header-breadcrumbs-offset-small/medium/large tokens and now uses margin-inline-start, so RTL is offset correctly too. Harmony (odeditor), Studio 2.0 (odeditor-dark) and Wixel are unaffected — their offset is 0, matching their current rendering. (#16690)Last updated: 20 October 2026