Card.Subheader

Components/Layout/Card

Deprecated. Card.Subheader is deprecated and will be removed in the next major version. Please use SectionHeader instead.

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

Overview

Copy

The card subheader divides card content into sections. It's an optional compound component of the <Card/>.

Do

  • Group related content under subheaders within a card.

Don't

  • Don't use it outside of the <Card/> component.

Feature examples

Structure

Card subheaders consist of 2 parts:

  • title labels contents under the subheader.
  • suffix is a container for an action button or other components.

Note that both parts are optional and their position is fixed.

Copy

Skin

Control the background color with the skin:

  • standard is the default and is used in most cases.
  • neutral is used to minimize the component's visual weight.
Copy

Title

Use title to summarize the content below the subheader.

Copy

Suffix

Use a suffix container to add info or actions that apply to the card content.

A variety of components can be used in the suffix:

  • <Button/>
  • <TextButton/>
  • <IconButton/>
  • <Text/>
  • <InfoIcon/>
  • Other components
Copy

Common use case examples

Grouping card content

Use card subheaders to organize card info into categories. It will make the whole card easier to scan.

Copy

Code

Copy

Props

NameTypeDefaultDescription
dataHookstring—Applies a data-hook HTML attribute to be used in the tests.
skin"standard" | "neutral"'standard'Controls the background color of a subheader.
suffixReactNode—Adds an empty container on the right side of a subheader. Commonly used to store action buttons or an info icon.
title (required)ReactNode—Sets a title text value. Title can also be overridden to any other component.

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
titleReturns title text.
titleNodeReturns title node.
suffixNodeReturns suffix node.
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

No released changes have been recorded for this component.

Last updated: 20 October 2026

Did this help?