Grid
Responsive card grids with image, icon, text, video, and YouTube card types.
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. Add, remove, or change card types as you go. Most grids use one card type throughout, but you can mix them.
Starting layouts
A new Grid asks how to start. Pick one of the small drawings and it fills in one click:
- Boxed Cards: three image cards on a Card Background, with centered Small Text and Match Height on
- Plain Cards: three image cards with the photo over left-aligned text
- Two Across: two wider image cards, Columns 2
- Four Across: four image cards with Small Text, Columns 4
- Icon Cards: three centered icon cards on a background with a light shadow, the icon in an Icon Background circle and Color Icons on; click an icon to choose it
Each choice only sets the Grid's ordinary sidebar settings, so change any of them afterwards as usual, or press Undo once to get the picker back. The cards show gray prompts rather than sample text, so there's nothing to delete. A Section's Grid and Dark Grid layouts add a Grid that shows this picker too.
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. Turn on Offsite Link under a card's Link URL when it goes to another website: the card's links then open in a new tab.
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 (choose Original to show whole images). An Image or Video card with nothing chosen shows no empty image space on the site, so it looks like a Text card; in a row with image cards its headline then sits higher. The editor keeps the empty space so you can click it to add one.
- Icon — an icon instead of a photo; Icon Size and icon color settings on the parent. Choose Icon opens the icon library (see Choosing icons); Upload Custom Icon uses your own image from the Media Library
- 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). Visitors can stop it with the small Pause button in the video's corner, which shows when they point at the video or tab to it (always on touch screens); pausing one pauses every background video on the page for the rest of their visit
- YouTube — an embedded YouTube video; paste the video ID in the card sidebar (the part after
v=in the YouTube URL)
Choosing icons
Click an empty icon in the editor, or the star button in the block toolbar, or Choose Icon in the card sidebar, to open the icon library: over 2,000 free icons from Font Awesome, or switch the Icon set menu (left of the styles) to Phosphor for a lighter, rounded look in Regular, Bold or Fill, or to Lucide for clean outline icons with even strokes in Regular, Thin or Bold. Search by what the icon shows or means (phone, leaf, calendar), and narrow Font Awesome to Solid, Outline or Brands (company logos such as Facebook or GitHub). Start typing to search, or browse below; click an icon to use it. To swap it later, use the star button (Replace icon) or Change Icon: the picker opens with the current icon first. It keeps the last set and style you picked while you work, so a whole grid stays in one look. The first time anyone on the site opens Phosphor or Lucide, it takes a few seconds to download.
Library icons take the text color, or the Icon Color when Color Icons is on, and they sit inside the colored circle when Icon Background is on. For a logo or a multi-color icon, use Upload Custom Icon instead: it works as before, with any image from the Media Library.
The first time anyone on a site opens the icon library, it may take a few seconds to load. After that it's instant.
Links (parent)
- Link Style — Button, Understated, Tab, Minimal, Prominent, or Bold for the bottom CTA
- Link Arrow — character shown beside link text (default
→) - Link Entire Card — make the whole card one link, labelled by its headline. Image Links and Title Links are hidden while it's on, since the whole card already links. Links inside the card text still go to their own pages.
- Image Links — make the card image clickable. On for new Grids.
- Title Links — make the headline clickable. On for new Grids.
- Hide Button — remove the bottom link when the card is already clickable. A hidden button isn't printed on the page at all, so search engines and screen readers don't find a stray "Learn More" link.
Set each card's URL in the child sidebar or toolbar when the card is selected. A card without a URL isn't linked, whichever link settings are on. Link text defaults to "Learn More" and is editable inline. When the link text is a general phrase like "Learn More" or "Read More", screen readers and search engines also hear the card's headline with it ("Learn More about Our Services"), so each card's link says where it goes. Visitors see the same button.
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, Original (no cropping: each image keeps its own shape), 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). Left at the default, H4, titles move up a level on the live site wherever H4 would skip one, for example to H3 under an H2 section title, so the outline stays in order for screen readers and search engines. They look the same, and the editor still shows H4. Any other level stays as you pick it.
- 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.
For a grid of headlines, turn on Hide Descriptions on the Grid. Cards then show only their media and headline, in the editor and on the page. The text stays saved in each card, so turning it off brings it back.
Switch to an Icon List
To turn a Grid into an Icon List, select the Grid, click its icon at the left of the block toolbar, and choose Icon List under Transform to. Each card keeps its icon, headline, text, and link, and the icon moves beside the text. Columns, card background, shadow, icon, and headline settings carry over.
Icon List only appears in the menu when nothing would be lost. It's left out when any card:
- shows a photo, video, emoji, or YouTube video (icon and text cards convert, as do image and video cards whose media is still empty; an emoji card shows a star when none is picked)
- has a heading, image, gallery, pills, or other block in its text that an Icon List item can't hold (paragraphs and lists are fine)
- shows its link button with wording other than "Learn More" (a hidden button is fine; the whole Icon List item becomes the link)
Icon List items have no alignment setting, so centered text goes back to the left.
Switch to a Structured List
To turn a Grid into a Structured List, select the Grid, click its icon at the left of the block toolbar, and choose Structured List under Transform to. Each card becomes a List Card with the same headline and text, and icon cards keep their icon. A card's link URL becomes the List Card's link, so the whole card links there, even when the Grid was hiding it. One column per row becomes the List layout; 2 to 5 columns carry over, and 6 or 7 become 5 (the most a Structured List has). Block width, Headline Style, Text Size, and Icon Size carry over, and Runner Size is set so larger icons keep a gap before the text. A card background becomes the Cards style; without one, the cards are Naked.
Structured List shows each icon as uploaded, beside the text. Icon circle and color, card and text color, shadow, gap, Match Height, link style, alignment, and image settings are dropped, and every headline becomes an H4.
Structured List only appears in the menu when nothing would be lost. It's left out when any card:
- shows a photo, video, emoji, or YouTube video (icon and text cards convert, as do image and video cards whose media is still empty)
- has anything but paragraphs and lists in its text (a heading, image, pills, social icons, or another block)
- shows its link button with wording other than "Learn More"
- uses an icon from the icon library: List Cards can only show an icon uploaded to the Media Library
- has no headline
- has a link URL and a link inside its headline, or a link in its text going somewhere else
It's also left out while Hide Descriptions is on, since a Structured List always shows its text.
Block width
Grid supports Wide and Full alignment.
Tips
- For a large or
.movcard video, click Optimize for web in the card sidebar to swap in a small MP4 copy (see Optimize background videos). - Three or four columns suits most grids.
- For cards that should click through anywhere, turn on Link Entire Card with Hide Button. Each card is then one link named by its headline, which reads better for visitors using screen readers and for search engines than a row of "Learn More" links.
- With Link Entire Card on, clicking an image inside the card text opens the card's link, not the image's lightbox. Links and buttons in the card text still work on their own.
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. -
Choose Icon opens the icon library: search over 2,000 Font Awesome icons and filter by Solid, Outline or Brands.
Settings
Grid Settings
Most cards per row (1–7). Cards wrap to the next row and drop to fewer columns on tablet and mobile.
Makes every card the same height, even when their text lengths differ.
Off by default.
Makes the whole card one link to the card's URL, read out as the card's headline. Image Links and Title Links are hidden while it's on, since the whole card already links. Links in the card text still work on their own.
Off by default.
Makes each card's image link to the card's URL. On for new Grids; a card without a URL isn't linked.
Off by default.
Makes each card's title link to the card's URL. On for new Grids; a card without a URL isn't linked.
Off by default.
Removes the link button from each card, so the page doesn't print it at all. Use it when Link Entire Card, Image Links, or Title Links already make the card clickable.
Off by default.
Shows only each card's media and headline, for grids of headlines. Card text stays saved, so turning it off brings it back; while it's on, the text isn't shown in the editor or printed on the page.
Off by default.
Adds a background color behind each card.
Off by default.
Appears when Card Background is on.
Appears when Card Background is on. Choose Light for dark card colors. Choosing a background color picks Dark or Light for you, whichever reads better on that color; change it any time.
Adds a drop shadow so cards appear to lift off the page.
Off by default.
How dark the shadow is. Appears when Card Shadow is on.
1 to 20. Default 2.
How far the shadow spreads. Appears when Card Shadow is on.
1 to 10. Default 3.
Makes card descriptions smaller. Headlines stay the same size.
Headlines
The heading level card titles use in the page outline. Left at H4, titles move up a level on the live site where H4 would skip one (H3 under an H2 section title); they look the same. Other levels stay as picked.
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.
Links
How the link at the bottom of each card looks.
The character shown after each card's link text.
Spacing
Space between cards, across and down.
0 to 4. Default 2.
Space between the edge of each card and its content.
0 to 8. Default 2.
Space between the image, icon, or video and the text below it.
0 to 4. Default 1.
Images
One shape for every image and video card. Original shows each one whole, at its own shape, with no cropping; fixed ratios range from 5:1 to 9:16. Selecting an image card points back here.
Corner shape of each card's image or video.
Icons
Icon size in pixels.
1 to 40. Default 20.
Puts each icon in a colored circle.
Off by default.
Recolors icons and emoji with the Icon Color you pick below.
Off by default.
Card
What fills this card. Image, icon, video, and YouTube each show their own fields.
- Image defaultA photo.
- IconAn icon image.
- EmojiA single emoji.
- VideoAn uploaded video. A large or .mov one shows an Optimize for web note in the card sidebar, which swaps in a small MP4 copy.
- TextText only, with no media.
- YouTubeA YouTube clip.
Content
The card headline. You can also edit it on the block.
Where this card links. Link Text appears once a URL is set.
Opens the card's link in a new tab, for links to another website, and doesn't tell that site which page the visitor came from. Appears once a URL is set. Links in the card text keep their own new-tab setting.
The link label. Appears after you set Link URL.

Drag the dot to the part of the photo that should stay in view. Appears on image cards; hidden when the Grid's Image Aspect Ratio is Original, since nothing is cropped. It follows the image's focal point from the Media Library until you move it here; after that it's this block's own.
The YouTube video ID for this card. Appears when Type is YouTube.
One emoji or character for this card. Appears when Type is Emoji.