The Post Grid display format loops through each post referenced by an ACF Post Object or Relationship field and renders them in a multi-column grid, similar to WordPress’s Query Loop. Each post 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 Post Grid display format supports the following field types (only when the field allows multiple values):

• Post Object (multi-select)
• Relationship

Inner Blocks (Loop Item)

The loop item is the template rendered once per post referenced by the field. Each post is exposed as block context (postId, postType), so any post-aware block placed inside resolves against that post.

How to add blocks

1. Click inside the loop item area. The block ships with a Post Title block as the default template.
2. Use the “+” inserter to add blocks. Common choices include:
   • Core post blocks: Post Title, Post Featured Image, Post Excerpt, Post Date, Post Author, Post Terms, etc.
   • ACF Sub-Field blocks (Text / Image / Button / Icon / etc.) targeting fields attached to the post type. Their Field Source auto-scopes to the current post.
3. Standard WordPress blocks (Group, Columns, Heading, Image, etc.) also work for layout.

Editing one item at a time

Only the first item’s loop item is editable in the canvas. The remaining cells render as live previews of that template (up to the column count for the current breakpoint). Click any preview to switch the active editing item.

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 posts.
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.