The Repeater Grid display format loops through each row of an ACF Repeater field and renders them in a multi-column grid. Each row becomes its own inner-block context, so any blocks inserted inside — including ACF Sub-Field blocks — repeat per row and resolve sub-field values automatically.

The number of columns is responsive — you set independent values for desktop, tablet, and mobile — and both horizontal and vertical gaps can be tuned.

Supported Field Types

The Repeater Grid display format supports the following field types:

• Repeater

Inner Blocks (Loop Item)

The loop item is the template rendered once per row of the bound repeater field. Each row is exposed as block context, so any ACF Sub-Field block placed inside resolves to that row’s sub-field values automatically.

How to add blocks

1. Click inside the loop item area. The placeholder reads “Click plus to add block or sub field into the repeater”.
2. Use the “+” inserter to add blocks. The inserter prioritizes the ACF Repeater Sub-Field block, which is the most common choice inside a repeater loop.
3. Standard WordPress blocks (Group, Columns, Heading, Image, etc.) also work — they’re cloned once per row but don’t read from the repeater context.

Resolving sub-field values

ACF Sub-Field blocks added inside the loop auto-scope their Field Source to the current repeater row — you don’t have to configure the source manually per block; just pick the sub-field name.

Editing one row at a time

Only the first row’s loop item is editable in the canvas. The remaining rows (up to the column count for the current breakpoint) render as live previews of that template. Click any preview to switch the active editing row.

Customization

Most of the layout’s appearance comes from the blocks you place inside the loop item. The sidebar controls focus on column count, spacing, and the empty-state fallback.

Customization	Description	Note
Items per row	Number of columns per breakpoint (desktop / tablet / mobile). Range: 1–8.	Use the responsive toggle to switch breakpoints.
Items Gap	Horizontal and vertical spacing between cells. Both axes can be set independently.	Lives in the Dimensions panel under “Items Gap”. Uses the theme’s spacing presets, split on axis.
Empty Message	Toggle (“Show message if empty”) plus fallback text shown when the repeater has no rows.
Layout Variations	Switch the variation to render the same field as a list or carousel instead of a grid.	The List / Grid / Carousel toggles share the same underlying block — switching only changes the type attribute.

The block also supports the following standard WordPress block controls: Block Alignment (wide, full), Margin, and Padding.