The User Grid display format loops through each user referenced by an ACF User field and renders them in a multi-column grid. Each user 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 User Grid 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 cells render as live previews (up to the column count for the current breakpoint). 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 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 users.
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.