Components/Layout
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/sectionheader
Section headers are used to group together content or items under a unifying title. They help users understand what the following section is about.
<SidePanel/> to introduce a new section of related content.<Accordion/> or a <Card/> to group together related items.<Page/>. Use <Page.Section/> instead.Control the size of a section header with the size prop:
medium (default) is the standard used in common cases.small is used in dense layouts and panels.Adjust the horizontalPadding of a section header according to the content padding inside the following section:
large (default)mediumsmalltinyxTinyxxTinyControl the style of a section header using the skin prop:
standard is the default and is used in most cases.neutral is used to minimize the component's visual weight.light is used as a completely minimal header that blends in with rest of the content.bold gives the title extra presence with the Madefor Display typeface, for a header that opens a page or a major section.The bold skin renders the title in the Madefor Display typeface at a heavier weight, with more space above it. Use it for the header that opens a page or a major section, where the title has to carry more weight than the section headers nested under it.
Keep one bold header per view. Pair it with standard or neutral headers for the sections beneath.
Control which dividers are visible with the divider prop:
top when there is already a divider at the bottom of a component.bottom when there is already a divider at the top of a component.none when there are already dividers at the top and bottom of a component.Use a suffix container to add info or actions that relate to the content below a section header.
A variety of components can be used in the suffix:
<InfoIcon/><TextButton/><Button/><IconButton/><Text/> or othersUse the title prop to describe the content that appears below the section header.
The default is a text value, but the container can accept any component.
Control the title's position with the align prop:
start (default) for left-aligned lists.center in settings panels.Title text that does not fit in one line gets truncated with an ellipsis.
The full text appears in a tooltip when hovering over the truncated text.
Use section headers to organize card info into separate categories.
This makes the whole card easier to scan.
By default, a section header title is a text element (<span>).
For better accessibility, use the as prop to render the section header title as a heading element.
| Name | Type | Default | Description |
|---|---|---|---|
align | "center" | "start" | 'start' | Controls the horizontal alignment of the title. |
aria-describedby | string | — | Title text element label reference id. |
as | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "span" | — | Renders component as any other component or a given HTML tag. |
dataHook | string | — | Applies a data-hook HTML attribute that can be used in the tests. |
divider | "none" | "default" | "top" | "bottom" | 'default' | Controls which borders the header displays. 'default' displays both top and bottom borders. |
horizontalPadding | "small" | "tiny" | "medium" | "large" | "xxTiny" | "xTiny" | 'large' | Controls the horizontal padding of the header. |
id | string | — | Title text element id. |
ref | null | string | (instance: HTMLDivElement | null) => void | RefObject<HTMLDivElement> | — | Allows getting a ref to the component instance. Once the component unmounts, React will set ref.current to null (or call the ref with null if you passed a callback ref). |
size | "small" | "medium" | 'medium' | Controls the size of the title text and the vertical padding of the header. |
skin | "standard" | "light" | "neutral" | "bold" | 'standard' | Controls the background and border colors of the header. |
suffix | ReactNode | — | Accepts any content to render at the end of the header, after the title. |
title (required) | ReactNode | — | Title text or element. React.ReactElement values aren't affected by as, id, aria-describedby, and size props or default text styling. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
getTitle | — |
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. |
Last updated: 22 October 2026