Card

Components/Layout/Card

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

Overview

Copy

Cards are containers that group related content and actions.

Do

  • Display content on a single topic.
  • Make cards easy to scan for important information.

Don't

  • Don't display content on unrelated topics.
  • Don't use cards to build gallery grids. To highlight videos and images use <CardGalleryItem/>.

Feature examples

Structure

Card layouts can vary, but they can include up to four related components:

Copy

The <Card.Header/> communicates what the card is about. It can include three elements:

  • title
  • subtitle
  • suffix

The suffix can be a button or toggle component.

Copy

Section header

The <SectionHeader/> divides card content into scannable sections. It can include two elements:

  • title
  • suffix

Find more information in <SectionHeader/> story.

Copy

Content

Cards can support any type of content. For example, text, radio buttons, and tables all can be used in cards as child components.

Copy

Divider

Dividers separate different content sections within cards.

When there's no <SectionHeader/>, use a divider to separate the header from other content.

Copy

Controls

Add the <CloseButton/> (with a default or a help icon) to cards using the controls prop.

Copy

Hide overflow

Clip card content into specific card dimensions with the hideOverflow prop.

Apply this property when a card contains overflowing components inside, like a scrollable table.

Copy

Stretch vertically

To make cards expand vertically to fit more content, use the stretchVertically prop.

Copy

Show shadow

To highlight a card with no header or subheader, use the showShadow prop. This is most commonly used in widgets. Note that in the Harmony and Studio 2.0 themes, the shadow is always shown regardless of the showShadow value.

Copy

Common use case examples

Form layouts

Use a card to group related form elements into a single layout.

Copy

Collapsable cards

Collapse and expand card content with the collapse mechanism.

The <ToggleSwitch/>, <IconButton/> and <TextButton/> components can trigger collapse and expand actions.

Copy

Widgets

Cards can be used as widgets within grids or custom layouts. To highlight one card, use the showShadow property.

These cards usually don't include headers or section headers.

Copy

Marketing layouts

<MarketingLayout/> should always be wrapped inside a card.

Copy

Empty states

If there's no content to display, add an <EmptyState/> component to guide users forward.

Copy

Code

Copy

Props

NameTypeDefaultDescription
childrenReactNode—Contains elements inside the card such as <Card.Header/>, <Card.Subeader/>, <Card.Content/> or <Card.Divider/>.
controlsReactNode—Contains elements that control the component, usually a <CloseButton/>.
dataHookstring—Applies a data-hook HTML attribute that can be used in tests.
hideOverflowboolean—Defines whether to hide portions of card content that overflows its dimensions.
highlight"focus"—Applies a highlighting effect on the borders of the component.
showShadowboolean—Defines whether to apply a drop shadow effect.
stretchVerticallyboolean—Makes a card stretch vertically to max height in a layout or container.

Testkit

No testkit for this component — it doesn't expose a unidriver testkit.

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.330.0 (2026-09-28) — maintenance release, no component-specific changes
  • 1.329.0 (2026-09-24) — maintenance release, no component-specific changes
  • 1.325.0 (2026-09-17) — maintenance release, no component-specific changes
  • 1.323.0 (2026-09-10) — maintenance release, no component-specific changes
  • 1.321.0 (2026-09-08) — fix: a header with no padded content directly below it — a collapsed <Collapse/>, a Card.Content with size="none", or no content at all — keeps its bottom padding instead of sitting flush against whatever follows, and the gap between Card.Header and its content is back to the intended size in Harmony (odeditor) and Studio 2.0 (odeditor-dark). A Card.Header placed directly above a Card.Subheader gains that gap too, where it previously had almost none. (#16991) — has visual changes
  • 1.318.0 (2026-08-28) — maintenance release, no component-specific changes
  • 1.313.1 (2026-08-18) — fix: controls are now kept above the card content, so positioned content can no longer paint over the close or help buttons. (#16772) — has visual changes
  • 1.313.1 (2026-08-18) — fix: controls position is now themeable through card.controls-padding-vertical and card.controls-padding-horizontal tokens. In the odeditor theme the controls sit 12px from the top and right edges; other themes keep their current position. (#16772) — has visual changes
  • 1.310.0 (2026-08-10) — maintenance release, no component-specific changes
  • 1.305.0 (2026-07-28) — fix: subtitle 12px, title-subtitle gap, top-aligned suffix, content paddings [Harmony, Studio 2.0] (#16634) — has visual changes
  • 1.299.0 (2026-07-17) — breaking: hide divider and show default shadow in odeditor themes (#16519) — has visual changes
  • 1.295.0 (2026-07-03) — maintenance release, no component-specific 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.278.0 (2026-05-08) — 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.241.0 (2025-12-17) — maintenance release, no component-specific changes
  • 1.234.0 (2025-12-03) — maintenance release, no component-specific changes
  • 1.220.0 (2025-09-29) — maintenance release, no component-specific changes
  • 1.213.0 (2025-08-19) — maintenance release, no component-specific changes
  • 1.212.0 (2025-08-11) — maintenance release, no component-specific changes
  • 1.205.0 (2025-07-15) — breaking: tokenization (#15062)
  • 1.179.1 (2025-04-10) — maintenance release, no component-specific changes
  • 1.179.0 (2025-04-09) — maintenance release, no component-specific changes
  • 1.176.2 (2025-04-03) — maintenance release, no component-specific changes
  • 1.176.1 (2025-04-02) — maintenance release, no component-specific changes
  • 1.175.0 (2025-03-31) — maintenance release, no component-specific changes
  • 1.171.0 (2025-03-14) — maintenance release, no component-specific changes
  • 1.147.0 (2024-12-13) — maintenance release, no component-specific changes
  • 1.138.1 (2024-10-30) — maintenance release, no component-specific changes
  • 1.128.0 (2024-09-19) — feat: add highlight prop (#14139)
  • 1.115.0 (2024-07-17) — maintenance release, no component-specific changes
  • 1.102.0 (2024-04-16) — maintenance release, no component-specific changes
  • 1.93.1 (2024-02-12) — 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?