SectionHeader

Components/Layout

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

Overview

Copy

Section headers are used to group together content or items under a unifying title. They help users understand what the following section is about.

Do

  • Use it in a <SidePanel/> to introduce a new section of related content.
  • Use it in an <Accordion/> or a <Card/> to group together related items.

Don't

  • Don't use it inside of a <Page/>. Use <Page.Section/> instead.

Feature examples

Size

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.
Copy

Horizontal padding

Adjust the horizontalPadding of a section header according to the content padding inside the following section:

  • large (default)
  • medium
  • small
  • tiny
  • xTiny
  • xxTiny
Copy

Skin

Control 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.
Copy

Bold skin

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.

Copy

Dividers

Control which dividers are visible with the divider prop:

  • By default, a section header has both top and bottom dividers.
  • Use top when there is already a divider at the bottom of a component.
  • Use bottom when there is already a divider at the top of a component.
  • Use none when there are already dividers at the top and bottom of a component.
Copy

Suffix

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 others
Copy

Title

Use 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.

Copy

Title alignment

Control the title's position with the align prop:

  • Use start (default) for left-aligned lists.
  • Use center in settings panels.
Copy

Title overflow

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.

Copy

Common use case examples

Group content in cards

Use section headers to organize card info into separate categories.

This makes the whole card easier to scan.

Copy

Accessibility examples

Title as a heading

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.

Copy

Code

Copy

Props

NameTypeDefaultDescription
align"center" | "start"'start'Controls the horizontal alignment of the title.
aria-describedbystring—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.
dataHookstring—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.
idstring—Title text element id.
refnull | 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.
suffixReactNode—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.

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
getTitle—
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.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.331.0 (2026-10-01) — fix: resolve the horizontal padding through the list-item tokens in all themes, with no visual change (#17268)
  • 1.330.2 (2026-09-29) — 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.326.0 (2026-09-17) — maintenance release, no component-specific changes
  • 1.325.0 (2026-09-17) — maintenance release, no component-specific changes
  • 1.320.0 (2026-09-03) — maintenance release, no component-specific changes
  • 1.310.0 (2026-08-10) — maintenance release, no component-specific changes
  • 1.299.0 (2026-07-17) — breaking: update token definitions (Harmony & Harmony Dark themes) (#16555) — has visual 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.266.0 (2026-04-07) — maintenance release, no component-specific changes
  • 1.260.0 (2026-03-17) — maintenance release, no component-specific changes
  • 1.251.0 (2026-01-28) — feat: made title and suffix sticky (#15849)
  • 1.247.2 (2026-01-21) — maintenance release, no component-specific changes
  • 1.213.0 (2025-08-19) — maintenance release, no component-specific changes
  • 1.119.0 (2024-07-31) — breaking: changing SectionHeader bg color in newBranding theme (#14000)
  • 1.115.0 (2024-07-17) — maintenance release, no component-specific changes
  • 1.106.0 (2024-05-24) — feat: add "light" skin support (#13769)
  • 1.104.1 (2024-05-14) — maintenance release, no component-specific changes
  • 1.102.0 (2024-04-16) — feat: skin background colors updated (#13582)
  • 1.98.0 (2024-03-15) — maintenance release, no component-specific changes
  • 1.92.1 (2024-02-05) — maintenance release, no component-specific changes

Last updated: 22 October 2026

Did this help?