Blocks for ACF Fields

Go Pro
Home › Documentation › Display Formats › Single User

Single User

PRO

The Single User display format renders the single user referenced by an ACF User field as a one-off block context — no loop, just one user. Any blocks inserted inside (ACF Sub-Field blocks bound to user fields, core user-aware blocks, etc.) resolve against the referenced user.

This format appears in the Load an ACF Field modal only when the bound User field is configured as single-select. For multi-select User fields, the modal offers User Loop variants (List / Grid / Carousel) instead.

Supported Field Types

The Single User display format supports the following field types (only when the field is configured for a single value):

  • User (single-select)

Inner Blocks (Item Content)

The block renders inner blocks once, against the single user referenced by the bound field. The 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 item content area.
  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 referenced user.
  3. Standard WordPress blocks (Group, Columns, Heading, Image, etc.) also work for layout.

There’s no per-row mechanic here — only one user is rendered.

Customization

Because only one user is rendered, the multi-item layout controls (column count, gaps, carousel settings) don’t apply.

CustomizationDescriptionNote
Empty MessageToggle (“Show message if empty”) plus fallback text shown when the field references no user.Lives in the Output Settings panel.

The block also supports the following standard WordPress block controls: Block Alignment (wide, full), Margin, and Padding.

Note: Single User uses the same underlying block as User Loop. If the bound field is changed from single-select to multi-select inside ACF, the same block can be flipped to a loop layout (List / Grid / Carousel).