Repeater
Repeat a layout over an ACF repeater field or other repeatable content.
The Repeater block renders a layout once for each row of repeatable content, most often an ACF repeater field. Build the layout for a single row and it repeats down the list automatically.
Where a query loops over posts, a repeater loops over the rows of a field, a list of features, team members, pricing tiers, or anything stored as repeating data. Repeaters can nest for data that has its own sub-lists.
Adding one
- Select the section or container to hold it.
- Open the inserter and search "repeater".
- Pick the Repeater block, then use the settings panel to choose a source and field.
Settings
In the repeater's own panel. Appearance lives in the shared design panel.
| Setting | What it does | Reach for it when |
|---|---|---|
| Source | Where the rows come from; defaults to ACF | You are pulling from a non-ACF data source |
| ACF group | The ACF field group that holds the repeater field | Narrowing the field list to the right group |
| ACF field | The specific repeater field whose rows to loop over | Always; without a field selected, the block renders nothing |
| Slider | Renders the rows as a slider instead of a stack or grid | A carousel of testimonials, a scrollable feature row |
| Masonry | Arranges rows in a masonry (variable-height) grid | Image galleries or cards with uneven content |
| Skeleton | Shows a loading placeholder while rows fetch | Useful on slower connections or when content is behind a gate |
Styling
The repeater uses the shared design panel for spacing, type, colour, borders, and effects, each per breakpoint. Style the repeater wrapper to control the grid or stack of rows, then select a block inside a row to style that element independently. The states panel is where hover and focus styles on inner blocks are set.
Accessibility
Each row the repeater produces is a structural repetition of the same DOM shape, so the markup inside the template row carries the full accessibility weight. Use real heading levels (not text styled to look like headings), write descriptive alt text on any images bound from the field, and make sure interactive elements inside a row have visible focus indicators. If the Slider mode is on, confirm that keyboard navigation moves between slides and that autoplay, if enabled, can be paused.