---
title: "User list"
canonical: "https://support.appfire.com/space/SCAFC/477463915/User%20list"
format: markdown
---
> Macro (aura-html)

The User list field in the Field Group macro creates a dropdown list for selecting one or more users from one or more predefined groups.

## Macro editor view

To insert a User list field into the Field Group macro editor, either drag it from the sidebar or use the `/user list` command.

![user_list_macro_editor.png](media://d84545cf-134f-4571-a7dc-0d6c96fd4d32)

## Field settings

To open the User list field settings, select the field in the Field Group macro editor and click **Edit **(:edit-pencil:).

| **Parameter** | **Type** | **Default value** | **Description** |
| --- | --- | --- | --- |
| **Field name** | Required | A random name is generated by default. | A unique name for the field. Used when integrating Scaffolding with other apps such as [Reporting for Confluence](https://appfire.atlassian.net/wiki/spaces/RFC). |
| **Helper text** | Optional | N/A | Context or additional information about the field input. Displayed below the field only in content edit mode. |
| **User Groups** | Optional | N/A | One or more groups to populate the dropdown list with their members. |
| **Allow Multiple** | Boolean | False | If enabled, the field accepts selecting more than one user. |
| **Required** | Boolean | False | If enabled, the field is mandatory.<br>> ℹ️ In the content editor, attempting to save the form with a mandatory field left empty results in an error. |

## Content editor view

When editing content in the Field Group macro, the User list field lets you select one or more users from one or more predefined groups.

![user_list_content_editor.png](media://62bebdec-fbee-4a2a-8df9-31634fe0cbbf)