The Repeater Accordion display format loops through each row of an ACF Repeater field and renders them as collapsible accordion sections. Each row becomes its own inner-block context: its header shows a chosen sub-field as the title, and the body holds any inner blocks you’ve placed inside the section.

The format is well-suited to FAQ lists, product specs, and any repeated content where visitors should be able to scan the headings and expand only the entries they care about.

Supported Field Types

The Repeater Accordion display format supports the following field types:

• Repeater

Inner Blocks (Section Body)

Each accordion section is composed of two parts: the header, which renders the value of the Title Sub Field chosen in the sidebar; and the body, which is composed of inner blocks. Every row of the bound repeater field becomes one section, with its sub-field values exposed as block context.

How to add blocks

1. Click inside the body area of the first (editable) section.
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 (Heading, Paragraph, Image, Group, etc.) also work — they’re cloned once per row.

Resolving sub-field values

ACF Sub-Field blocks added inside the body auto-scope their Field Source to the current repeater row — just pick the sub-field name.

Editing one row at a time

Only the first row’s body is editable in the canvas. The remaining sections render their headers but skip the body preview. Click any section to bring its body into focus.

Customization

Sidebar controls cover the section header (title source, alignment, toggle icon), the open/close behavior, and styling of header / body in both collapsed and expanded states.

Customization	Description	Note
Title Sub Field	Which sub-field of the repeater is rendered as each section’s header text.	Dropdown is populated from the repeater’s sub-fields.
Title Alignment	Horizontal alignment of the header text. Options: left, center, right.
Icon Position	Where the open/close toggle icon sits. Options: left, right, hide.
Initially open first item	When enabled, the first section starts expanded on page load.	Does not affect the editor preview — verify on the front end.
Only one open at a time	When enabled, opening a section closes any other open section.	Does not affect the editor preview.
Header Text Color	Header text color in collapsed and expanded states (set independently).
Header Background Color	Header background color in collapsed and expanded states.
Header Icon Color	Toggle icon color in collapsed and expanded states.	Hidden when Icon Position is set to “Hide”.
Body Text Color	Text color of the section body.
Body Background Color	Background color of the section body.
Items Gap	Vertical spacing between accordion sections.
Header Padding	Inner padding of each section header. Top / right / bottom / left can be set independently.
Body Padding	Inner padding of each section body.
Empty Message	Toggle (“Show message if empty”) plus fallback text shown when the repeater has no rows.

The block also supports the following standard WordPress block controls: Block Alignment (wide, full), Typography (font size, line height, family, weight, style, transform, decoration, letter spacing), Border, and Shadow.