Site color

Choose your site’s color palette.

Saved on this device.

SectionHeader

SectionHeaderContent hierarchy

Introduce a section with a clear hierarchy: context, title, subtitle, and a small supporting note.

Layout & content

In context

An editorial introductionCOMPOSITION
THE WORKSPACE

A home for your next idea

Arrange the essentials, then make room for what comes next.

Updated with the latest design review.

12 projects

All four text layers, custom classes, a deliberate heading level, a title anchor, and content in the default slot.

<div class="component-recipe">
<SectionHeader eyebrow="THE WORKSPACE" title="A home for your next idea" subtitle="Arrange the essentials, then make room for what comes next." footnote="Updated with the latest design review." titleTag="h3" titleId="workspace-heading" eyebrowClass="mb-2" titleClass="fs-h3 mb-2" subtitleClass="mb-3" footnoteClass="mb-3">
<Badge tone="feature">12 projects</Badge>
</SectionHeader>
</div>

A complete section heading

Each text layer has a distinct job. The default heading level is h2.

THE COMPONENT SYSTEM

Small pieces. Complete interfaces.

Compose a page from focused components that share one theme.

Every example includes its source.

<SectionHeader
  eyebrow="THE COMPONENT SYSTEM"
  title="Small pieces. Complete interfaces."
  subtitle="Compose a page from focused components that share one theme."
  footnote="Every example includes its source."
/>

Fit the document hierarchy

Use h3 when the header belongs inside a section. Utility classes adjust appearance without changing semantics.

Within a card

The heading level follows the document, not the font size.

Ready to use
<Panel bodyClass="p-4">
  <SectionHeader
    title="Within a card"
    titleTag="h3"
    titleClass="fs-h4 mb-2"
    subtitle="The heading level follows the document, not the font size."
    subtitleClass="mb-0"
  >
    <Badge tone="success">Ready to use</Badge>
  </SectionHeader>
</Panel>

Every title element

titleTag accepts h1–h6, p, div, or span. These samples use a uniform visual size so you can compare the actual elements. Use heading levels that fit your real document.

Every title elementCOMPOSITION
h1

h1 title

h2

h2 title

h3

h3 title

h4

h4 title

h5
h5 title
h6
h6 title
p

p title

div
div title
span
span title

Every value is visible. Compare treatments in the site’s light and dark themes.

Optional text layers

Each missing layer is omitted. A title-only header can be enough; add context when it helps.

Optional text layersCOMPOSITION
Title only

Project library

Context + title
WORKSPACE

Project library

Full hierarchy
WORKSPACE

Project library

A home for your next idea.

Updated today.

Every value is visible. Compare treatments in the site’s light and dark themes.

Styling each layer

SectionHeader has no tone or variant props. Style its four text layers with eyebrowClass, titleClass, subtitleClass, and footnoteClass. titleId creates a linkable title; the default slot adds supporting content after the text.

<div class="component-recipe">
<SectionHeader eyebrow="THE WORKSPACE" title="A home for your next idea" subtitle="Arrange the essentials, then make room for what comes next." footnote="Updated with the latest design review." titleTag="h3" titleId="workspace-heading" eyebrowClass="mb-2" titleClass="fs-h3 mb-2" subtitleClass="mb-3" footnoteClass="mb-3">
<Badge tone="feature">12 projects</Badge>
</SectionHeader>
</div>

Behavior and accessibility

Choose heading levels in order. Visual size and heading semantics are independent. Empty text props omit their blocks; avoid empty headings and do not use the eyebrow as the only label.

API reference

SectionHeader contract

Props below are the public template API. RefOrValue accepts a literal or a reactive ref; bind refs with a colon-prefixed attribute. Native attributes and events can be passed through the component root.

eyebrow

RefOrValue<string>
Default
not set

Short context above the heading, such as a category or release label.

title

RefOrValue<string>
Default
not set

Visible heading. Choose a short title that identifies the content or task.

subtitle

RefOrValue<string>
Default
not set

Supporting text beneath the title.

footnote

RefOrValue<string>
Default
not set

Supporting note below the section description.

titleTag

RefOrValue<string>
Default
h2

Heading element. Accepts h1–h6, p, div or span; invalid values fall back to h2. Match the surrounding document hierarchy.

titleId

RefOrValue<string>
Default
not set

Id on the title element. Reference it from the surrounding section with aria-labelledby.

eyebrowClass

RefOrValue<string>
Default
not set

Additional classes on the eyebrow element. Use existing typography and spacing utilities.

titleClass

RefOrValue<string>
Default
not set

Additional classes on the title element. Use existing typography and spacing utilities.

subtitleClass

RefOrValue<string>
Default
not set

Additional classes on the subtitle element. Use existing typography and spacing utilities.

footnoteClass

RefOrValue<string>
Default
not set

Additional classes on the footnote element. Use existing typography and spacing utilities.

Composition

Default slot: content following all text blocks, such as a badge or supporting link. Register defineSectionHeaderComponents.