Grid

Responsive card grids with image, icon, text, video, and YouTube card types.

View demo

Usage

The Grid block lays out cards in rows, like a set of services, features, or linked image tiles. You could approximate this with core Columns, but Grid rearranges cards automatically to fit smaller screens.

The Grid holds Card blocks. New grids start with image cards, and you can add, remove, or change card types. Most grids use one card type throughout, but you can mix them.

Parent and child blocks

Select Grid for layout, styling, and link behavior that applies to all cards. Select an individual Card to edit its media, headline, description, and link URL.

Click the inserter prompt after the last card to add more. Use the parent block button, breadcrumb path, or List View to jump between grid and card.

Columns and responsive layout

Columns sets the most cards per row (1–7 on desktop). Extra cards wrap to the next row, and the grid drops to fewer columns on smaller screens on its own.

Match Height equalizes card height when content lengths vary.

Card types

Change a card's type from the child sidebar, or use Quick-Set Card Type on the parent to convert all cards at once:

  • Image (default) β€” photo at the top; crop controlled by parent Image Aspect Ratio
  • Icon β€” image icon instead of a photo; Icon Size and icon color settings on the parent
  • Emoji β€” emoji character instead of a photo or uploaded icon
  • Text β€” headline and copy only, no top media
  • Video β€” hosted video at the top (autoplay, loop, muted)
  • YouTube β€” an embedded YouTube video; paste the video ID in the card sidebar (the part after v= in the YouTube URL)

Links (parent)

  • Link Style β€” Button, Understated, Tab, Minimal, Prominent, or Bold for the bottom CTA
  • Link Arrow β€” character shown beside link text (default β†’)
  • Image Links β€” make the card image clickable
  • Title Links β€” make the headline clickable
  • Hide Button β€” hide the bottom link when image or title linking is enough

Set each card's URL in the child sidebar or toolbar when the card is selected. Link text defaults to "Learn More" and is editable inline.

Appearance (parent)

  • Card Background β€” fill behind each card, with Background Color and Text Color (dark or light)
  • Card Shadow β€” optional depth with Shadow Weight and Shadow Size
  • Small Text β€” reduces body copy size (not the headline); also toggled from the block toolbar
  • Image Aspect Ratio β€” Default, None, or fixed ratios (1:1, 4:3, 16:9, 9:16, etc.)
  • Corners β€” Sharp, Rounded, or Full on card media
  • Grid Gap, Content Spacing, Media Spacing β€” space between cards and inside cards

Headlines (parent)

  • Headline Tag β€” the heading level card titles use in the page outline (H2–H6, or plain paragraph)
  • Headline Appearance β€” how card titles look, using your Customizer text styles

Icons (parent)

For icon and emoji cards:

  • Icon Size, Icon Background (colored circle), Color Icons, and Icon Color

Block toolbar (parent)

  • Alignment β€” text alignment within cards
  • Toggle Background β€” card background on/off
  • Toggle Text Size β€” normal vs small body text

Card content (child)

Each card supports a headline, description (paragraphs/lists), optional media (image, icon, emoji, video, or YouTube), and a link. Click media in the editor to replace it.

Block width

Grid supports Wide and Full alignment.

Tips

  • Three or four columns suits most grids.
  • Turn on Image Links or Title Links with Hide Button for cleaner cards that are still clickable.

Screenshots

Front-end

  • Icon cards on a dark section β€” rounded cards with recolored icons in colored circles.
  • Three image cards with headline and description between wavy section transitions.

Editor

  • Grid parent settings β€” card style, icon size, icon background, and icon color.
  • Card child settings β€” type, headline, link text, and image focal point.

Settings

Grid Settings

Quick-Set Card Type
  • Image
  • Icon
  • Emoji
  • Video
  • Text
  • YouTube
Columns setting in the block editor sidebar
Columns

Most cards per row (1–7). Cards wrap to the next row and drop to fewer columns on tablet and mobile.

  • 1
  • 2
  • 3default
  • 4
  • 5
  • 6
  • 7
Match Height setting in the block editor sidebar
Match Height

Makes every card the same height, even when their text lengths differ.

Card Background setting in the block editor sidebar
Card Background

Adds a background color behind each card.

Background Color setting in the block editor sidebar
Background ColorOnly appears when you enable the card background.

Appears when Card Background is on.

Text Color setting in the block editor sidebar
Text ColorOnly appears when you enable the card background.

Appears when Card Background is on. Choose Light for dark card colors.

  • Inheritdefault
  • Dark Text
  • Light Text
Card Shadow setting in the block editor sidebar
Card Shadow

Adds a drop shadow so cards appear to lift off the page.

Shadow Weight setting in the block editor sidebar
Shadow WeightVisible when you turn on the card shadow.

How dark the shadow is. Appears when Card Shadow is on.

Shadow Size setting in the block editor sidebar
Shadow SizeVisible when you turn on the card shadow.

How far the shadow spreads. Appears when Card Shadow is on.

Shadow Offset setting in the block editor sidebar
Shadow OffsetVisible when you turn on the card shadow.
Small Text setting in the block editor sidebar
Small Text

Makes card descriptions smaller. Headlines stay the same size.

Headlines

Headline Tag setting in the block editor sidebar
Headline Tag

The heading level card titles use in the page outline. Match it to the headings around the grid.

  • <h2>
  • <h3>
  • <h4>default
  • <h5>
  • <h6>
  • <p>
Headline Appearance setting in the block editor sidebar
Headline Appearance

How card titles look. It's separate from Headline Tag, so a title can look like an H2 while staying an H4 in the page outline.

  • <h1>
  • <h2>
  • <h3>
  • <h4>default
  • <h5>
  • <h6>
  • <p>
  • <strong>
Link Style setting in the block editor sidebar
Link Style

How the link at the bottom of each card looks.

  • Button
  • Understateddefault
  • Tab
  • Minimal
  • Prominent
  • Bold
Link Arrow setting in the block editor sidebar
Link Arrow

The character shown after each card's link text.

Spacing

Grid Gap setting in the block editor sidebar
Grid Gap

Space between cards, across and down.

Content Spacing setting in the block editor sidebar
Content Spacing

Space between the edge of each card and its content.

Media Spacing setting in the block editor sidebar
Media Spacing

Space between the image, icon, or video and the text below it.

Images

Image Aspect Ratio setting in the block editor sidebar
Image Aspect Ratio

One shape for every image and video card. None shows media uncropped; fixed ratios range from 5:1 to 9:16.

  • Defaultdefault
  • None
  • 5:1
  • 4:1
  • 3:1
  • 2:1
  • 16:9
  • 4:3
  • 1:1
  • 1:2
  • 9:16
Corners setting in the block editor sidebar
Corners

Corner shape of each card's image or video.

  • Sharpdefault
  • Rounded
  • Full

Icons

Icon Size setting in the block editor sidebar
Icon Size

Icon size in pixels.

Icon Background setting in the block editor sidebar
Icon Background

Puts each icon in a colored circle.

Background Color setting in the block editor sidebar
Background ColorShown when you enable the icon background.
Color Icons setting in the block editor sidebar
Color Icons

Recolors icons and emoji with the Icon Color you pick below.

Icon Color setting in the block editor sidebar
Icon ColorAvailable after you enable colored icons.

Card

Type
  • Imagedefault
  • Icon
  • Emoji
  • Video
  • Text
  • YouTube

Content

Headline
Link URL
Link Text
Image Focal Point
YouTube ID
Emoji