The Term List display format loops through each term referenced by an ACF Taxonomy field and renders them in a vertical list. Each term becomes its own block context, so any blocks inserted inside the loop item — including ACF Sub-Field blocks bound to fields on the looped term — repeat per row.
Supported Field Types
The Term List display format supports the following field types (only when the field allows multiple values):
- Taxonomy (multi-select, checkbox)
Inner Blocks (Loop Item)
The loop item is the template rendered once per term referenced by the field. Each term is exposed as block context (termId, taxonomy), so any term-aware block placed inside resolves against that term.
How to add blocks
- Click inside the loop item area. The block ships with a Term Name block as the default template (on WordPress 6.9+; older versions fall back to the plugin’s Term Name field block).
- Use the “+” inserter to add blocks. Common choices include:
- Term Name (WordPress 6.9+) or the plugin’s Term Name field block for term properties (name, description, slug, etc.).
- ACF Sub-Field blocks (Text / Image / Button / Icon / etc.) targeting fields attached to the taxonomy. Their Field Source auto-scopes to the current term.
- Standard WordPress blocks (Group, Columns, Heading, Image, etc.) also work for layout.
Editing one item at a time
Only the first term’s loop item is editable in the canvas. The remaining terms render as live previews of that template. Click any preview to switch the active editing term.
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”. |
| Empty Message | Toggle (“Show message if empty”) plus fallback text shown when the field references no posts. | |
| 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.