The Post List display format loops through each post referenced by an ACF Post Object or Relationship field and renders them in a vertical list, similar to WordPress’s Query Loop. Each post becomes its own block context, so any blocks inserted inside the loop item — including ACF Sub-Field blocks pointing at fields on the looped post — repeat per row.

This is the simplest of the post-loop layouts: posts stack top-to-bottom, with the gap between them as the only spacing control.

Supported Field Types

The Post List 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; the placeholder reads “Click plus to add block or sub field into the loop”.
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 posts render as live previews of that template. 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 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.