MarketingLayout

Components/Layout

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

Overview

Copy

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.

Copy

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

Image position

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

Copy

Image background color

Add a background color to an image with imageBackgroundColor.

Copy

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.

Copy

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

Common use case examples

Multi-column layout

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

Copy

Footnote

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

Copy

Code

Copy

Props

NameTypeDefaultDescription
actionsReactNode—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.
badgeReactNode—Adds a container for a <Badge/> component at the top left corner. Affect component height.
dataHookstring—Applies a data-hook HTML attribute that can be used in the tests.
descriptionReactNode—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.
hiddenBadgebooleanfalseSpecifies whether the badge is hidden. Can be used to add additional vertical spacing, if no badge is given.
imageReactNode—Accepts image URL or a custom element to be displayed on the side of content.
imageBackgroundColorstring—Specifies image area background color. Can be a keyword from color palette or any supported CSS color value (HEX, RGB, etc.).
imagePaddingbooleantrueEnables padding inside image container. Use with direction="horizontal" layout only.
invertedbooleanfalseFlips 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.
titleReactNode—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) — 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) — 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) — 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) — 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

Last updated: 21 October 2026

Did this help?