user

WP user picker. Single or multi-select with drag-to-reorder. Stores user IDs by default, or full user objects when configured.

Stored value

number (single) or number[] (multi) by default; or user-object(s) when `returnFormat: "object"`

Supports

  • Single or multi-select (`multiple`, default `false`)
  • Drag-to-reorder selected users (multi-select only)
  • Search via `/wp/v2/users`

Config options

multiplebooleandefault: false
Allow selecting more than one user.
returnFormatstring
`"id"` (default) or `"object"`. With `"object"` the saved value is `{ id, name }`.

Example

json
{ "id": "ctrl_authors",
  "type": "user",
  "label": "Authors",
  "attributeKey": "authors",
  "multiple": true,
  "parentPanelId": "panel" }

Gotchas

Heads up
Default is `multiple: false` — single-select. Set `multiple: true` for author teams etc.
Heads up
Search hits `/wp/v2/users` which only returns users with published content unless the current user can `list_users`. Editors may see different results than admins.