The User List display format loops through each user referenced by an ACF User field and renders them in a vertical list. Each user becomes its own block context, so any blocks inserted inside the loop item — including ACF Sub-Field blocks bound to fields on the looped user — repeat per row.

Supported Field Types

The User List display format supports the following field types (only when the field allows multiple values):

• User (multi-select)

Inner Blocks (Loop Item)

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

How to add blocks

1. Click inside the loop item area. The block ships with a User Field block as the default template (configured to render the user’s display name and link to the author archive).
2. Use the “+” inserter to add blocks. Common choices include:
   • The plugin’s User Field block for user properties (display name, login, email, nicename, URL).
   • ACF Sub-Field blocks (Text / Image / Button / Icon / etc.) targeting fields attached to users. Their Field Source auto-scopes to the current user.
3. Standard WordPress blocks (Group, Columns, Heading, Image, etc.) also work for layout.

Editing one item at a time

Only the first user’s loop item is editable in the canvas. The remaining users render as live previews of that template. Click any preview to switch the active editing user.

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