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

## Article: MarketingLayout Component

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

## Article Content:

# MarketingLayout

_Components/Layout_

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

## Overview

```jsx
<Card>
  <MarketingLayout
    title="Build customer loyalty with Membership Plans"
    description="Reward loyals guests with discounts and special deals. Create and offer plans with different discount levels."
    actions={<Button size="small">Get Started</Button>}
    image={
      <Box width="100%" align="right">
        <Image width="120px" src="IllustrationPricingPlan.svg" transparent />
      </Box>
    }
  />
</Card>;
```

Marketing layout is a standardized card-like layout for encouraging users to take an action. It is quicker and easier to use than a customizable card.

### Do

- Use it to promote existing features or products that users could benefit from.
- Wrap it in a `<Card/>`, which provides a white background.

### Don't

- Don't use it to create lists. Use `<Table/>` instead.

### Feature examples

#### Structure

This component consists of `title`, `description`, `actions` and `image` container areas.

- These areas accept any component as a child element.
- Each area is optional, so the component can be customized according to your needs.

Marketing layout should be wrapped inside a `<Card/>`, which provides a white background.

```jsx
<MarketingLayout
  title="Title"
  description="Description"
  actions={<Button size="small">Button</Button>}
  image={<Image width="180px" height="120px" />}
/>;
```

#### Size

Adjust the component's size using the `size` property. It supports three values:

- `tiny` is used for promoting optional or ancillary features, or when multiple layouts are displayed in the same row.
- `small` is the default, and is used in all common cases.
- `medium` is for promoting core or mandatory releases. Use it in spacious layouts only.

```jsx
() => {
  const MarketingLayoutImage = ({ width, height, title }) => (
    <StorybookComponents.Stack width="100%" justifyContent="flex-end">
      <StorybookComponents.Placeholder width={width} height={height}>
        <StorybookComponents.Stack
          justifyContent="center"
          height="100%"
          alignItems="center"
        >
          <Heading>{title}</Heading>
        </StorybookComponents.Stack>
      </StorybookComponents.Placeholder>
    </StorybookComponents.Stack>
  );

  return (
    <StorybookComponents.Stack flexDirection="column">
      <Card>
        <MarketingLayout
          size="tiny"
          title="Tiny"
          description="Description"
          actions={<Button size="small">Small Button</Button>}
          image={<MarketingLayoutImage width="96px" height="96px" title="S2" />}
        />
      </Card>
      <Card>
        <MarketingLayout
          size="small"
          title="Small"
          description="Description"
          actions={<Button size="small">Small Button</Button>}
          image={
            <MarketingLayoutImage width="180px" height="120px" title="M2" />
          }
        />
      </Card>
      <Card>
        <MarketingLayout
          size="medium"
          title="Medium"
          description="Description"
          actions={<Button>Medium Button</Button>}
          image={
            <MarketingLayoutImage width="240px" height="156px" title="L1" />
          }
        />
      </Card>
    </StorybookComponents.Stack>
  );
};
```

#### Image position

Change the image's position from right to left with the `inverted` property.

```jsx
() => {
  const MarketingLayoutImage = () => (
    <StorybookComponents.Stack>
      <StorybookComponents.Placeholder>
        <StorybookComponents.Stack
          width="180px"
          height="120px"
          justifyContent="center"
          alignItems="center"
        >
          <Heading>M2</Heading>
        </StorybookComponents.Stack>
      </StorybookComponents.Placeholder>
    </StorybookComponents.Stack>
  );

  return (
    <StorybookComponents.Stack flexDirection="column">
      <Card>
        <MarketingLayout
          title="Default layout"
          description="This layout has an image on the right side."
          actions={<Button size="small">Button</Button>}
          image={<MarketingLayoutImage />}
        />
      </Card>
      <Card>
        <MarketingLayout
          inverted
          title="Inverted layout"
          description="This layout has an image on the left side."
          actions={<Button size="small">Button</Button>}
          image={<MarketingLayoutImage />}
        />
      </Card>
    </StorybookComponents.Stack>
  );
};
```

#### Image background color

Add a background color to an image with `imageBackgroundColor`.

```jsx
<Card hideOverflow>
  <MarketingLayout
    title="Title"
    description="Description"
    actions={<Button size="small">Action</Button>}
    imageBackgroundColor="B40"
    image={
      <StorybookComponents.Stack>
        <StorybookComponents.Placeholder>
          <StorybookComponents.Stack
            width="180px"
            height="120px"
            justifyContent="center"
            alignItems="center"
          >
            <Heading>M2</Heading>
          </StorybookComponents.Stack>
        </StorybookComponents.Placeholder>
      </StorybookComponents.Stack>
    }
  />
</Card>;
```

#### Badge

Emphasize new or top items with a customizable label in the top left corner using the `badge` property.

Note that adding a badge increases the marketing layout's height. To keep layouts that are displayed in a row aligned, you can use the `hiddenBadge` property to add extra height to other layouts.

```jsx
() => {
  const MarketingLayoutImage = () => (
    <StorybookComponents.Stack>
      <StorybookComponents.Placeholder>
        <StorybookComponents.Stack
          width="180px"
          height="120px"
          justifyContent="center"
          alignItems="center"
        >
          <Heading>M2</Heading>
        </StorybookComponents.Stack>
      </StorybookComponents.Placeholder>
    </StorybookComponents.Stack>
  );

  return (
    <StorybookComponents.Stack flexDirection="column">
      <Card>
        <MarketingLayout
          badge={<Badge size="small">badge</Badge>}
          title="With badge"
          description="Description"
          actions={<Button size="small">Action</Button>}
          image={<MarketingLayoutImage />}
        />
      </Card>
      <Card>
        <MarketingLayout
          hiddenBadge
          title="Hidden badge"
          description="Description"
          actions={<Button size="small">Action</Button>}
          image={<MarketingLayoutImage />}
        />
      </Card>
    </StorybookComponents.Stack>
  );
};
```

#### Vertical alignment

Control how content is vertically aligned with the `alignItems` property. It supports two values:

- `center` (default) centers the content vertically.
- `stretch` vertically stretches content to match the height of the image.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <Card>
    <MarketingLayout
      title="Centered"
      description="This layout  centers its content vertically to the image on the right"
      actions={<Button size="small">Action</Button>}
      image={<Image height="180px" />}
    />
  </Card>
  <Card>
    <MarketingLayout
      alignItems="stretch"
      title="Stretched"
      description="This layout  stretches its content to fill the container instead of the default centered alignment."
      actions={<Button size="small">Action</Button>}
      image={<Image height="180px" />}
    />
  </Card>
</StorybookComponents.Stack>;
```

### Common use case examples

#### Multi-column layout

Display multiple marketing layouts in the same row to promote multiple features at the same time.

```jsx
<Page>
  <Page.Content>
    <Layout>
      <Cell>
        <PageSection title="Suggested for you" showDivider />
      </Cell>
      <Cell span={6}>
        <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>
      </Cell>
      <Cell span={6}>
        <Card>
          <MarketingLayout
            title="Create an email campaign"
            description="Send updates, offers or newsletters & keep in touch."
            actions={<Button size="small">Send Campaign</Button>}
            size="tiny"
            hiddenBadge
            alignItems="stretch"
            image={
              <Box width="100%" align="right">
                <Image
                  width="120px"
                  src="PromotionalPromoteMarketingHomeEmail.svg"
                  transparent
                />
              </Box>
            }
          />
        </Card>
      </Cell>
    </Layout>
  </Page.Content>
</Page>;
```

#### Footnote

Append a footnote containing notes or conditions by adding a divider and a box to the same card the `<MarketingLayout/>` is wrapped in.

```jsx
<Card>
  <MarketingLayout
    title="Add sessions to get booked"
    description="Set when this service is offered and which staff member will provide it."
    actions={
      <Box gap="6px">
        <Button size="small">Add Sessions</Button>
        <Button size="small" skin="inverted">
          Learn More
        </Button>
      </Box>
    }
    size="small"
    image={
      <Box width="100%" align="right">
        <Image width="120px" src="PromotionalBookingsUpgrade.svg" transparent />
      </Box>
    }
  />
  <Divider />
  <Box align="left" padding="12px 30px">
    <Text size="tiny" secondary>
      You can also add sessions directly from your <a>Calendar</a>.
    </Text>
  </Box>
</Card>;
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `actions` | `ReactNode` | — | Sets marketing layout actions. Accepts single or multiple interactive components. Most commonly contain `<Button/>` or `<TextButton/>`. |
| `alignItems` | `"center" \| "stretch"` | `'center'` | Controls the vertical alignment of the content. |
| `badge` | `ReactNode` | — | Adds a container for a `<Badge/>` component at the top left corner. Affect component height. |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute that can be used in the tests. |
| `description` | `ReactNode` | — | Sets the marketing layout description. Accepts text string or a custom element. |
| `direction` | `"horizontal" \| "vertical"` | `'horizontal'` | Controls content direction. Ignored when `mobile` is enabled on `<WixDesignSystemProvider/>` — the layout then always stacks vertically with the image above the content. |
| `hiddenBadge` | `boolean` | `false` | Specifies whether the badge is hidden. Can be used to add additional vertical spacing, if no badge is given. |
| `image` | `ReactNode` | — | Accepts image URL or a custom element to be displayed on the side of content. |
| `imageBackgroundColor` | `string` | — | Specifies image area background color. Can be a keyword from color palette or any supported CSS color value (HEX, RGB, etc.). |
| `imagePadding` | `boolean` | `true` | Enables padding inside image container. Use with `direction="horizontal"` layout only. |
| `inverted` | `boolean` | `false` | Flips content layout. If true, the image is displayed on the left side of the content. Ignored when `mobile` is enabled on `<WixDesignSystemProvider/>` — the layout then always stacks with the image above the content regardless of this prop. |
| `size` | `"small" \| "tiny" \| "medium"` | `'small'` | Controls the size of the marketing layout.<br/> |
| `title` | `ReactNode` | — | Sets the marketing layout title. Accepts text string or a custom element. |

## Testkit

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

## Changelog

- **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.335.0** (2026-10-12) — maintenance release, no component-specific changes
- **1.330.3** (2026-09-29) — maintenance release, no component-specific changes
- **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.318.0** (2026-08-28) — breaking: in Harmony (odeditor) the content is top-aligned instead of vertically centered, the tiny title matches the other sizes' letter spacing, the image keeps its inset even with `imagePadding={false}` so it can no longer render full-bleed, and a URL image stays inside the card when a badge or long content makes the card taller. ([#16842](invalid-url)) — has visual changes
- **1.313.1** (2026-08-18) — fix: in the odeditor theme the cards now match the spec heights — 140px (tiny), 160px (small) and 180px (medium) — and an image passed as a URL is squared to the card height minus its 12px insets, so it keeps equal padding on all sides and grows when the card grows. Title to description gap is 4px for small and medium, and the tiny title uses Madefor Display. Other themes are visually unchanged. ([#16772](invalid-url)) — has visual changes
- **1.313.1** (2026-08-18) — fix: the description width is now themeable through a `marketing-layout.description-max-width` token. In the odeditor theme it is capped at 80% of the text container; other themes are unchanged. ([#16772](invalid-url)) — has visual changes
- **1.313.1** (2026-08-18) — fix: actions are now right-aligned in the odeditor theme when the layout is inverted (image on the left) and horizontal. Other themes are visually unchanged. ([#16772](invalid-url)) — has visual changes
- **1.310.0** (2026-08-10) — maintenance release, no component-specific changes
- **1.298.0** (2026-07-14) — 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.288.0** (2026-06-15) — 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.258.0** (2026-02-23) — maintenance release, no component-specific changes
- **1.250.0** (2026-01-27) — maintenance release, no component-specific changes
- **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.92.1** (2024-02-05) — maintenance release, no component-specific changes