The Repeater List display format loops through each row of an ACF Repeater field and renders them in a vertical list layout. 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.

This is the simplest of the repeater layouts: rows stack top-to-bottom and the only spacing control is the vertical gap between them.

Supported Field Types

The Repeater List display format supports the following field types:

• Repeater

Inner Blocks (Item Content)

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 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 the spacing between rows and the empty-state fallback.

Customization	Description	Note
Items Gap	Vertical spacing between rows.	Lives in the Dimensions panel under “Items Gap”. Uses the theme’s spacing presets.
Empty Message	Toggle (“Show message if empty”) plus fallback text shown when the repeater has no rows.	Lives in the Output Settings panel.
Layout Variations	Switch the variation in the block toolbar to render the same field as a grid or carousel instead of a list.	The List / Grid / Carousel toggles share the same underlying block — switching only changes the type attribute, so other settings persist.

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