Promotion cards section
The Promotion cards section of Combine shows image or video cards with text and a button, as a slider or a grid.
Applies to: Combine 4.2.0 and later. Added in: Combine 1.0.0. Last checked: 2026-10-13 against Combine 4.2.0.
The Promotion cards section shows up to 12 cards with an image or a video, a caption, a title, a subtitle and a button under the media, as a slider or a grid.
Where to find it: in the theme editor, select Add section and choose Promotion slider. The section starts with four cards.
Layout
- Desktop layout sets the cards per row on desktop: 2 columns, 3 columns (the default) or 4 columns. On screens narrower than 768 px, one card shows per row; 4 columns become 2 below 1024 px.
- Media aspect ratio crops every card image to one shape: Short (4:3), Square (1:1) (the default), Tall (5:6) or Taller (2:3).
- Layout is Slider (the default), which scrolls sideways, or Grid.
Text style
- Text alignment aligns the card text: Left, Center (the default) or Right.
- Caption size, Title size and Subtitle size set the size of each line: Small or Regular.
- Text spacing sets the gap between the lines, from -12 to 60 px (default 18 px).
- Button style is Outline (the default) or Solid.
Custom card design
Border radius rounds the corners of the cards, 0 to 30 px. The section heading, background colors, margins and heading tag work as described in General section styling.
Blocks
Card
- Image is the card picture, cropped to Media aspect ratio.
- Video plays muted in a loop instead of the image; the image shows when the video cannot play. Use different media on mobile shows Mobile video file on small screens, with its own Mobile video aspect ratio.
- Caption, Title and Subtitle are the three lines of text under the media. Leave any of them empty to hide it.
- Button label sets the button text (default "Show more").
- Link is where the card goes. With a Button label, the link is on the button; without one, the whole card is the link.
- Background, Text and Border under Custom card design give the card its own colors. Hide border removes the line around it.
- Heading tag under SEO sets the HTML level of the card title (default H3).
Should I use Promotion cards or Flex cards?
Use Promotion cards for a fixed layout of media, caption, title, subtitle and button that is quick to fill in. Use the Flex cards section when cards need other blocks, such as a star rating, a quick buy button or two buttons, or different widths.
How do I show the cards in a grid instead of a slider?
Set Layout to Grid. The cards then wrap into rows of the Desktop layout columns instead of scrolling sideways.
All Promotion cards settings
Every setting of this section, with its type and default.
Accepts these blocks: Card (up to 12 blocks in the section).
Promotion cards section: Section heading
Where to find it: Promotion cards → Section heading
The Promotion cards section uses the standard Section heading settings, listed in General section styling.
Heading (text field, default: "Promotions slider"): Sets the section title. Leave Heading, Subheading and Button label empty to hide the heading area.
Subheading (formatted text, default: "Share your best offers").
Heading size (dropdown, default: Regular). Options: Regular, Large.
Text alignment (dropdown, default: One row: Left). Options: One row: Left, Two rows: Left, Two rows: Center.
Button label (text field): Adds a button to the heading area on desktop; below 768 px it shows under the section as a full-width button.
Button link (link). Shown only when Button label is set.
These settings differ from the standard ones or exist only here:
Heading (text field, default: "Promotions slider"): Sets the section title. Leave Heading, Subheading and Button label empty to hide the heading area.
Promotion cards section: Layout
Where to find it: Promotion cards → Layout
Desktop layout (dropdown, default: 3 columns): Sets the cards per row on desktop. Below 768 px one card shows per row; 4 columns become 2 below 1024 px. Options: 2 columns, 3 columns, 4 columns.
Media aspect ratio (dropdown, default: Square (1:1)): Crops every card image to this shape. Options: Short (4:3), Square (1:1), Tall (5:6), Taller (2:3).
Layout (dropdown, default: Slider): Shows the cards as a slider that scrolls sideways, or as a grid. Options: Slider, Grid.
Promotion cards section: Text style
Where to find it: Promotion cards → Text style
Text alignment (dropdown, default: Center). Options: Left, Center, Right.
Caption size (dropdown, default: Regular). Options: Small, Regular.
Title size (dropdown, default: Small). Options: Small, Regular.
Subtitle size (dropdown, default: Small). Options: Small, Regular.
Text spacing (slider -12 to 60 px, default: 18 px): Sets the gap between the caption, title, subtitle and button.
Button style (dropdown, default: Outline). Options: Outline, Solid.
Promotion cards section: Custom card design
Where to find it: Promotion cards → Custom card design
Border radius (slider 0 to 30 px, default: 0 px): Rounds the corners of the cards.
Promotion cards section: Section design
Where to find it: Promotion cards → Section design
The Promotion cards section uses the standard Section design settings, listed in General section styling.
Background color (color, default: transparent): Fills the section around the cards, not the cards.
Background gradient (gradient).
Heading text color (color, default: transparent): Sets the color of the section heading and subheading only.
Promotion cards section: Gutter
Where to find it: Promotion cards → Gutter
The Promotion cards section uses the standard Gutter settings, listed in General section styling.
Decrease top margin (checkbox, default: off): Makes the space above the section smaller.
Remove bottom margin (checkbox, default: off): Pulls the next section up, so the two sections touch.
Promotion cards section: SEO
Where to find it: Promotion cards → SEO
The Promotion cards section uses the standard SEO settings, listed in General section styling.
Heading tag (dropdown, default: H2): Sets the HTML level of the section heading for search engines; span gives it no level. It does not change the size. Options: H1, H2, H3, H4, span.
Card block
Where to find it: Promotion cards → Add block → Card
Image (image): Sets the card picture, cropped to Media aspect ratio.
Video (video): Plays a muted, looping video instead of the image. The image shows when the video cannot play.
Use different media on mobile (checkbox, default: off): Shows a different video on screens narrower than 768 px. Shown only when Video is set.
Mobile video file (video). Shown only when Use different media on mobile is on and Video is set.
Mobile video aspect ratio (dropdown, default: Natural): Sets the shape of the mobile video. Natural keeps the video's own proportions. Options: Natural, Wide (16:9), Short (4:3), Square (1:1), Tall (5:6), Taller (2:3), Tallest (9:16). Shown only when Use different media on mobile is on and Mobile video file is set and Video is set.
Card block: Text content
Where to find it: Promotion cards → Add block → Card → Text content
Caption (text field, default: "Introducing").
Title (text field, default: "Your best promotion yet").
Subtitle (text field, default: "Write about it").
Button label (text field, default: "Show more").
Link (link): Sets where the card goes. With a Button label the link is on the button; without one the whole card is the link.
Open link in a new window (checkbox, default: off). Shown only when Link is set.
Card block: Custom card design
Where to find it: Promotion cards → Add block → Card → Custom card design
Background (color, default: transparent): Sets the card background.
Text (color, default: transparent): Sets the card text color.
Border (color, default: transparent): Sets the color of the line around the card.
Hide border (checkbox, default: off).
Card block: SEO
Where to find it: Promotion cards → Add block → Card → SEO
Heading tag (dropdown, default: H3): Sets the HTML level of the card title for search engines. Options: H1, H2, H3, H4, span.
Related pages
- Flex cards section: promotion cards built from theme blocks.
- Media with text overlay section: cards with the text over the media.
- Image size recommendations: image sizes per aspect ratio.
- General section styling: the standard section settings.