Add a dropdown list of users

Description

Create a dropdown to select one or more users from a specific list or group.

Add to a page

For this example, let’s add a user list to the first empty cell in an existing table.

To add a user list to a page,

1. Select the location you would like to add the user list.
   
   

   Open

   

2. From the Confluence top menu, choose + option to add content.

3. Select View more.
   
   

   Open

   

4. In the Browse select macro popup, search for scaffolding

5. Choose Scaffolding Field Group.

The Field Group settings dialog box is displayed with the available fields below.

In the Add Fields section,

1. Scroll down until you can see the User List.

2. Drag User List to the right, into the empty field area, then release the mouse button to place the user list field.
   
   

3. After placing the user list, you can configure its dropdown options.

4. Select the placed user list.

5. Click Field settings or select the Edit button on the macro.

You can choose which users will be displayed in the expanded Field settings section.

For this example, we will only display users from the "apps-leaders" group.

The other user list options are,

• Multiple - allows more than one option to be chosen from the dropdown

• Required - mandatory fields that cannot be left blank

7. After you have completed the field settings, choose Save to continue.

8. You can continue to edit the page or choose Publish/Update to publish the page.

Access user lists

Once the page is published, the user list can be accessed by selecting the Edit Content button.

The user list picker is displayed on the page,

• Choose Select users.

• Select a user from the dropdown.

After updating, choose Save Changes or Cancel if you do not want the changes.

Alternatively, you can click Cancel to discard the changes.

Differences between the Cloud version and Server version

The Scaffolding for Confluence Cloud user lists are now grouped under the Scaffolding Field Group macro.