> 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: Card Component

## Article: Card Component

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

## Article Content:

# Card

_Components/Layout/Card_

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

## Overview

```jsx
<Card>
  <Card.Header
    title="Monthly insights report"
    subtitle="Get the key takeaways from the last 30 days."
  />
  <Card.Divider />
  <Card.Content>
    <Layout>
      <Cell>
        <Box height="200px" />
      </Cell>
    </Layout>
  </Card.Content>
</Card>;
```

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:

- [`<Card.Header/>`](https://wix-pages.com/design-system-documentation/#/component/card-header)
- `<SectionHeader/>`
- `<Card.Content/>`
- [`<Card.Divider/>`](https://wix-pages.com/design-system-documentation/#/component/card-divider)

```jsx
<Card>
  <Card.Header title="Card header"></Card.Header>
  <SectionHeader title="Section header" />
  <Card.Content>
    <StorybookComponents.Placeholder height="120px">
      Card content
    </StorybookComponents.Placeholder>
  </Card.Content>
</Card>;
```

#### Header

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.

```jsx
<Card>
  <Card.Header
    title="Title"
    subtitle="Subtitle"
    suffix={<TextButton>Suffix</TextButton>}
  ></Card.Header>
  <Card.Divider />
  <Card.Content>
    <Box height="120px" />
  </Card.Content>
</Card>;
```

#### Section header

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

- `title`
- `suffix`

Find more information in `<SectionHeader/>` story.

```jsx
<Card>
  <Card.Header title="Title" />
  <SectionHeader
    title="Section header title"
    suffix={<TextButton size="small">Suffix</TextButton>}
  ></SectionHeader>
  <Card.Content>
    <Box height="120px" />
  </Card.Content>
</Card>;
```

#### Content

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

```jsx
<Card>
  <Card.Header title="Title" />
  <Card.Divider />
  <Card.Content>
    <StorybookComponents.Placeholder height="120px">
      Content
    </StorybookComponents.Placeholder>
  </Card.Content>
</Card>;
```

#### Divider

Dividers separate different content sections within cards.

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

```jsx
<StorybookComponents.Stack flexDirection="column">
  <Card>
    <Card.Header title="Title" />
    <Card.Divider />
    <Card.Content>
      <Box height="120px" />
    </Card.Content>
  </Card>
  <Card>
    <Card.Header title="Title" />
    <Card.Divider />
    <Card.Content>
      <Layout>
        <Cell span={12}>
          <Box height="120px" />
        </Cell>
        <Cell span={12}>
          <Card.Divider />
        </Cell>
        <Cell span={12}>
          <Box height="120px" />
        </Cell>
      </Layout>
    </Card.Content>
  </Card>
</StorybookComponents.Stack>;
```

#### Controls

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

```jsx
<Card controls={<CloseButton size="large" skin="dark" />}>
  <Card.Header title="Title" />
  <Card.Divider />
  <Card.Content>
    <Box height="120px" />
  </Card.Content>
</Card>;
```

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

```jsx
<Layout>
  <Cell>
    <StorybookComponents.Stack flexDirection="column" height="300px">
      <Card hideOverflow={true}>
        <Card.Header title="Hidden overflow" />
        <Card.Divider />
        <Card.Content>
          <StorybookComponents.Placeholder height="500px" />
        </Card.Content>
      </Card>
    </StorybookComponents.Stack>
  </Cell>
</Layout>;
```

#### Stretch vertically

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

```jsx
<Layout cols={12}>
  <Cell span={12}>
    <Text secondary weight="normal">
      Default
    </Text>
  </Cell>
  <Cell span={12}>
    <Layout cols={12}>
      <Cell span={4}>
        <Card>
          <Card.Content>
            <StorybookComponents.Placeholder height="180px" />
          </Card.Content>
        </Card>
      </Cell>
      <Cell span={4}>
        <Card>
          <Card.Content>
            <StorybookComponents.Placeholder height="120px" />
          </Card.Content>
        </Card>
      </Cell>
      <Cell span={4}>
        <Card>
          <Card.Content>
            <StorybookComponents.Placeholder height="60px" />
          </Card.Content>
        </Card>
      </Cell>
    </Layout>
  </Cell>
  <Cell span={12}>
    <Text secondary weight="normal">
      With stretchVertically
    </Text>
  </Cell>
  <Cell span={12}>
    <Layout cols={12}>
      <Cell span={4}>
        <Card stretchVertically>
          <Card.Content>
            <StorybookComponents.Placeholder height="180px" />
          </Card.Content>
        </Card>
      </Cell>
      <Cell span={4}>
        <Card stretchVertically>
          <Card.Content>
            <StorybookComponents.Placeholder height="120px" />
          </Card.Content>
        </Card>
      </Cell>
      <Cell span={4}>
        <Card stretchVertically>
          <Card.Content>
            <StorybookComponents.Placeholder height="60px" />
          </Card.Content>
        </Card>
      </Cell>
    </Layout>
  </Cell>
</Layout>;
```

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

```jsx
<Card showShadow>
  <Card.Content>
    <Box height="180px" />
  </Card.Content>
</Card>;
```

### Common use case examples

#### Form layouts

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

```jsx
() => {
  const options = [
    { id: 0, value: 'Online Store' },
    { id: 1, value: 'Other' },
  ];
  return (
    <Card>
      <Card.Header
        title="Profile"
        subtitle="Your profile shows on search results, invoices, chat and more."
      />
      <Card.Divider />
      <Card.Content>
        <Box direction="vertical" gap="4">
          <Layout>
            <Cell span={6}>
              <FormField labelSize="small" label="Business name">
                <Input placeholder="" />
              </FormField>
            </Cell>
            <Cell span={6}>
              <FormField
                labelSize="small"
                label="Which category best matches your business?"
              >
                <Dropdown
                  size="medium"
                  placeholder="Category"
                  options={options}
                  selectedId={0}
                />
              </FormField>
            </Cell>
          </Layout>
          <Layout>
            <Cell span={6}>
              <Box direction="horizontal" gap="3" verticalAlign="middle">
                <FormField labelSize="small" label="Logo">
                  <AddItem theme="image" tooltipContent="Add Logo">
                    Add Item
                  </AddItem>
                </FormField>
                <Box direction="vertical" gap="1">
                  <Text size="small" secondary>
                    For best results, upload a high resolution image.
                  </Text>
                  <TextButton size="small">Add Logo</TextButton>
                </Box>
              </Box>
            </Cell>
            <Cell span={6}>
              <FormField labelSize="small" label="Short description">
                <InputArea
                  placeholder="Add more details about your business."
                  rows={3}
                  hasCounter
                  resizable
                />
              </FormField>
            </Cell>
          </Layout>
        </Box>
      </Card.Content>
    </Card>
  );
};
```

#### Collapsable cards

Collapse and expand card content with the collapse mechanism.

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

```jsx
() => {
  const [open, setOpen] = React.useState(true);
  const [radio, setRadio] = React.useState(1);
  return (
    <Card>
      <Card.Header
        title="Set post limits"
        subtitle="You can limit the number of posts members can create in their first week."
        suffix={
          <ToggleSwitch
            onChange={() => setOpen(!open)}
            size="medium"
            checked={open}
          />
        }
      />
      <Collapse open={open}>
        <Card.Divider />
        <Card.Content>
          <RadioGroup
            value={radio}
            onChange={(value) => setRadio(Number(value))}
          >
            <RadioGroup.Radio value={1}>20</RadioGroup.Radio>
            <RadioGroup.Radio value={2}>15</RadioGroup.Radio>
            <RadioGroup.Radio value={3}>10</RadioGroup.Radio>
          </RadioGroup>
        </Card.Content>
      </Collapse>
    </Card>
  );
};
```

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

```jsx
() => {
  const CustomCard = ({ title, suggested = false }) => {
    const [hovered, setHovered] = React.useState(false);
    return (
      <div
        onMouseEnter={() => setHovered(true)}
        onMouseLeave={() => setHovered(false)}
      >
        <Card showShadow={hovered}>
          <Layout gap={0}>
            <Cell span={12}>
              <Box height="18px" marginTop={2} marginLeft={-1}>
                {suggested && (
                  <Badge size="small" skin="standard">
                    SUGGESTED FOR YOU
                  </Badge>
                )}
              </Box>
            </Cell>
            <Cell>
              <Box height="72px" padding="12px 24px 0 24px">
                <Heading size="small">{title}</Heading>
              </Box>
            </Cell>
            <Cell>
              <Box padding="24px">
                <Button priority="secondary" size="small">
                  Set Up Automation
                </Button>
              </Box>
            </Cell>
          </Layout>
        </Card>
      </div>
    );
  };
  return (
    <Layout>
      <Cell span={4}>
        <CustomCard
          suggested
          title="Email customers when a product is back in stock "
        />
      </Cell>
      <Cell span={4}>
        <CustomCard title="Send a coupon to visitors who abandon a cart" />
      </Cell>
      <Cell span={4}>
        <CustomCard title="Ask customers for feedback via email" />
      </Cell>
    </Layout>
  );
};
```

#### Marketing layouts

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

```jsx
<Card>
  <MarketingLayout
    title="Get found on Google"
    description="Boost your site's SEO with the SEO Wiz. Follow your step-by-step plan."
    actions={<Button size="small">Start Now</Button>}
    size="tiny"
    badge={<Badge size="small">Essential</Badge>}
    image={
      <Box width="100%" align="right">
        <Image
          width="120px"
          src="PromotionalPromoteMarketingHomeSEO.svg"
          transparent
        />
      </Box>
    }
  />
</Card>;
```

#### Empty states

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

```jsx
<Card>
  <Card.Header
    title="New Arrivals collection"
    suffix={
      <Button size="small" prefixIcon={<Icons.Add />}>
        Add Product
      </Button>
    }
  />
  <Card.Divider />
  <Card.Content>
    <EmptyState
      title="Add your first product"
      subtitle="Bring more attention to new products."
      theme="section"
    >
      <TextButton size="small" prefixIcon={<Icons.Add />}>
        Add Product
      </TextButton>
    </EmptyState>
  </Card.Content>
</Card>;
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `children` | `ReactNode` | — | Contains elements inside the card such as `<Card.Header/>`, `<Card.Subeader/>`, `<Card.Content/>` or `<Card.Divider/>`. |
| `controls` | `ReactNode` | — | Contains elements that control the component, usually a `<CloseButton/>`. |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute that can be used in tests. |
| `hideOverflow` | `boolean` | — | Defines whether to hide portions of card content that overflows its dimensions. |
| `highlight` | `"focus"` | — | Applies a highlighting effect on the borders of the component. |
| `showShadow` | `boolean` | — | Defines whether to apply a drop shadow effect. |
| `stretchVertically` | `boolean` | — | 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](invalid-url)) — 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](invalid-url)) — 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](invalid-url)) — 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](invalid-url)) — has visual changes
- **1.299.0** (2026-07-17) — breaking: hide divider and show default shadow in odeditor themes ([#16519](invalid-url)) — 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](invalid-url))
- **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](invalid-url))
- **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