> To build a Wix site agentically, or add Wix features like bookings or a store to a site you already have, follow https://www.wix.com/headless/skill.md
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: SectionHeader Component

## Article: SectionHeader Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/layout/section-header-component.md

## Article Content:

# SectionHeader

_Components/Layout_

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

## Overview

```jsx
<SectionHeader
  title="Products"
  suffix={
    <TextButton size="small" prefixIcon={<Icons.Add />}>
      Add Product
    </TextButton>
  }
/>;
```

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.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SectionHeader title="Medium" size="medium" />
  <SectionHeader title="Small" size="small" />
</StorybookComponents.Stack>;
```

#### 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`

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SectionHeader title="Large" horizontalPadding="large" />
  <SectionHeader title="Medium" horizontalPadding="medium" />
  <SectionHeader title="Small" horizontalPadding="small" />
  <SectionHeader title="Tiny" horizontalPadding="tiny" />
  <SectionHeader title="Extra tiny" horizontalPadding="xTiny" />
  <SectionHeader title="Extra-extra tiny" horizontalPadding="xxTiny" />
</StorybookComponents.Stack>;
```

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

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SectionHeader title="Standard" skin="standard" />
  <SectionHeader title="Neutral" skin="neutral" />
  <SectionHeader title="Light" skin="light" />
  <SectionHeader title="Bold" skin="bold" />
</StorybookComponents.Stack>;
```

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

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SectionHeader skin="bold" title="Store products" />
  <SectionHeader skin="standard" title="Inventory" />
  <SectionHeader skin="standard" title="Shipping" />
</StorybookComponents.Stack>;
```

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

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SectionHeader title="Default" />
  <SectionHeader title="Top" divider="top" />
  <SectionHeader title="Bottom" divider="bottom" />
  <SectionHeader title="No dividers" divider="none" />
</StorybookComponents.Stack>;
```

#### 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

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SectionHeader
    title="Title"
    suffix={
      <InfoIcon
        size="small"
        content="Info icon gives more information about a section."
      />
    }
  />
  <SectionHeader
    title="Title"
    suffix={
      <TextButton
        size="tiny"
        priority="secondary"
        prefixIcon=<Icons.AddSmall />
      >
        Suffix
      </TextButton>
    }
  />
  <SectionHeader
    title="Title"
    suffix={
      <Button size="tiny" priority="secondary">
        Suffix
      </Button>
    }
  />
  <SectionHeader
    title="Title"
    suffix={
      <IconButton size="tiny" priority="secondary">
        <Icons.MoreSmall />
      </IconButton>
    }
  />
  <SectionHeader title="Title" suffix={<Text size="tiny">Suffix</Text>} />
</StorybookComponents.Stack>;
```

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

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SectionHeader title="Default" />
  <SectionHeader
    title={
      <Text weight="bold" size="small">
        Custom title
      </Text>
    }
  />
  <SectionHeader title=<StorybookComponents.Placeholder height="24px" /> />
</StorybookComponents.Stack>;
```

#### Title alignment

Control the title's position with the `align` prop:

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

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SectionHeader title="Start" align="start" />
  <SectionHeader title="Center" align="center" />
</StorybookComponents.Stack>;
```

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

```jsx
<SectionHeader title="A very long section title goes into a title container in this case. It even has multiple sentences inside. It will be truncated by ellipses once it reaches the second line" />;
```

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

```jsx
() => {
  const items = [
    {
      sectionTitle: 'Monday, Feb 7',
    },
    {
      time: '7:00 PM - 9:00 PM',
      event: 'Registration & reception',
    },
    {
      sectionTitle: 'Tuesday, Feb 8',
    },
    {
      time: '8:00 AM - 10:00 AM',
      event: 'Keynote address by Steven H. Kastner',
      divider: true,
    },
    {
      time: '10:00 AM - 1:00 PM',
      event: 'Break & networking',
      divider: true,
    },
    {
      time: '1:00 PM - 3:00 PM',
      event: 'Keynote address by Linda Contreras',
      divider: true,
    },
    {
      time: '7:00 PM - 9:00 PM',
      event: 'Evening reception',
    },
    {
      sectionTitle: 'Wednesday, Feb 9',
    },
    {
      time: '8:00 AM - 10:00 AM',
      event: 'Keynote address by Susan W. Eaton',
      divider: true,
    },
    {
      time: '10:00 AM - 1:00 PM',
      event: 'Keynote address by Bjorn Rettig',
    },
  ];

  const pirmaryAction = {
    text: 'Edit',
    onClick: () => ({}),
  };

  const secondaryActions = [
    {
      text: 'Hide',
      icon: <Icons.HiddenSmall />,
      onClick: () => ({}),
    },
    {
      text: 'Cancel',
      icon: <Icons.BlockSmall />,
      onClick: () => ({}),
    },
    {
      text: 'Delete',
      icon: <Icons.DeleteSmall />,
      onClick: () => ({}),
    },
  ];

  const actionsList = (
    <TableActionCell
      primaryAction={pirmaryAction}
      secondaryActions={secondaryActions}
      numOfVisibleSecondaryActions={0}
      size="small"
    />
  );

  const primaryAction = (
    <Button size="small" priority="secondary" prefixIcon={<Icons.AddSmall />}>
      Add Item
    </Button>
  );

  return (
    <Card hideOverflow>
      <Card.Header
        title="Event schedule"
        subtitle="Build a schedule to keep guests informed throughout your event."
        suffix={primaryAction}
      />
      {items.map((params) => {
        if (params.sectionTitle) {
          return <SectionHeader title={params.sectionTitle} size="small" />;
        }
        return (
          <TableListItem
            showDivider={params.divider}
            onClick={() => {}}
            options={[
              { value: <Text size="small">{params.time}</Text>, width: '25%' },
              { value: <Text size="small">{params.event}</Text>, width: '50%' },
              { value: actionsList },
            ]}
          />
        );
      })}
    </Card>
  );
};
```

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

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SectionHeader title="Default" />
  <SectionHeader title="Title as <h3> heading" as="h3" />
</StorybookComponents.Stack>;
```

## Code

```jsx
import { SectionHeader } from '@wix/design-system';
```

### Props

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

## Testkit

Import the driver matching your test environment:

```jsx
// UniDriver
import { SectionHeaderUniDriver } from '@wix/design-system/dist/testkit/unidriver';

// Vanilla
import { SectionHeaderTestkit } from '@wix/design-system/dist/testkit';

// Puppeteer
import { SectionHeaderTestkit } from '@wix/design-system/dist/testkit/puppeteer';

// Testing Library
import { SectionHeaderTestkit } from '@wix/design-system/dist/testkit/testing-library';
```

### Driver methods

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

## 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](invalid-url))
- **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](invalid-url)) — 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](invalid-url))
- **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](invalid-url))
- **1.115.0** (2024-07-17) — maintenance release, no component-specific changes
- **1.106.0** (2024-05-24) — feat: add "light" skin support ([#13769](invalid-url))
- **1.104.1** (2024-05-14) — maintenance release, no component-specific changes
- **1.102.0** (2024-04-16) — feat: skin background colors updated ([#13582](invalid-url))
- **1.98.0** (2024-03-15) — maintenance release, no component-specific changes
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes