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.