The Term Grid display format loops through each term referenced by an ACF Taxonomy field and renders them in a multi-column grid. Each term becomes its own block context, so any blocks inserted inside the loop item repeat per cell.
The number of columns is responsive — independent values for desktop, tablet, and mobile — and both horizontal and vertical gaps can be tuned.
Supported Field Types
The Term Grid 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.
- 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 cells render as live previews (up to the column count for the current breakpoint). 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 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. | |
| Items Gap | Horizontal and vertical spacing between cells, set independently. | Lives in the Dimensions panel under “Items Gap”. |
| Empty Message | Toggle (“Show message if empty”) plus fallback text shown when the field references no terms. | |
| 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.