Breakout Grid
Usage
Breakout Grid presents a central theme at the top, then breaks out into a row of supporting cards below. Use it to supplement existing page content, highlight numbered points, or turn a single idea into a scannable list.
The layout has three layers:
- Top bubble β a circular panel with your Icon, Headline, and sizing controls (Bubble Size, Icon Size).
- Transition image (optional) β a full-width image between the bubble and the card grid. Hidden below the extra-large breakpoint so mobile layouts stay compact.
- Cards grid β one to five cards in a responsive grid. Column count follows the number of cards you add.
All fields live in the block sidebar. Select the Breakout Grid block in the editor to edit parent settings and manage cards in the Cards repeater.
Top bubble
- Icon β image shown inside the circular bubble at the top.
- Icon Size β height of the icon in
rem(0β20, default 2). - Headline β short title under the icon inside the bubble. Rendered as an
h2with your chosen Headline Style. - Headline Style β Customizer typography preset (
h1βh6, defaulth4). Changes appearance only; the semantic tag staysh2. - Bubble Size β diameter of the circular bubble in
rem(0β30, default 6).
Transition image
Transition Image is optional. When set, it spans the full width between the bubble and cards on large screens. On smaller viewports the image is hidden so the bubble flows directly into the card grid.
Cards
Add between one and five cards with Add Card. Each card includes:
- Label β short badge text (default
1). Shown on a primary-colored pill. Use numbers, letters, or short tags. - Headline β card title, rendered as an
h3with Card Title Style (defaulth4). - Body β rich text with the Dirigible toolbar. Media upload is disabled; use inline formatting only.
Card Title Style and Card Label Style set Customizer typography presets for card titles and labels (h1βh6 or strong). Defaults are h4 for titles and h2 for labels.
The grid uses a {count}-per-row class based on how many cards you have, so one card is a single column and five cards spread across five columns at appropriate breakpoints.
Block width
Breakout Grid supports Wide and Full alignment from the block toolbar and defaults to Wide.
- Wide β uses more horizontal space than default content width.
- Full β spans the full page width; adjacent full-width blocks sit flush with no gap between them.
Tips
- Keep the bubble Headline short β it sits inside a circle and shares space with the icon.
- Use Label for step numbers or short category tags; put the main point in each card Headline.
- Add a Transition Image when you want a visual bridge between the theme bubble and the card row on desktop.
- For a simpler list without the bubble motif, consider Structured List. For image-forward grids, see Overlay Grid or Lookbook.
Screenshots
Front-end
-
Front-end layout showing the bubble, optional transition area, and card grid.
Editor
-
Icon Size control in the block sidebar adjusts icon height within the top bubble. -
Headline Style selects a Customizer typography preset for the bubble headline. -
Card fields include Label, Headline, and Body for each repeater row.
Settings
Breakout Grid

Select an icon to display at the top of the Breakout Grid. This icon helps visually represent the overarching idea of the grid.

Height of the icon inside the top bubble, in rem (0β20, default 2).

Enter the main headline for the Breakout Grid. This headline introduces the overarching idea or theme that the grid's content will explore.

Customizer typography preset for the bubble headline (h1βh6, default h4). Visual only β the semantic tag remains h2.

Diameter of the circular top bubble in rem (0β30, default 6). Controls how much space the icon and headline occupy.

Optional full-width image between the top bubble and card grid. Shown on extra-large screens and up; hidden on smaller viewports.

Customizer typography preset for each card headline (h1βh6 or strong, default h4). Visual only β the semantic tag remains h3.

Customizer typography preset for each card's label badge (h1βh6 or strong, default h2). Visual only β labels render inside a styled span.

Configure the individual cards that make up the Breakout Grid. Each card represents a distinct idea or point related to the overall theme.

Enter the main headline for the Breakout Grid. This headline introduces the overarching idea or theme that the grid's content will explore.