Customized User List Macro
Create customized lists of users
The Customized User List Macro enables you to display a list of users filtered by a profile field value. For example this macro can be used to create a simple phone book for your department (see first image) or to list your team members on your team homepage or similar use cases, where you want to display a custom list of users. You are also able to configure which profile fields are shown in the list. The user list will only show people that have access to confluence.
The second image shows the configuration options for the macro:
Search Options
- Choose the profile field you want to filter on (e.g., "Location").
- Enter the value you want to filter for (e.g., "Wiesbaden").
- Add as many profile fields as you want to narrow your search request.
Display Options
- Displayed profile fields
Choose the profile fields you want to be displayed as additional columns in the list (e.g., "Phone" and "Position"). The users avatar and name are always displayed. - Ordered by
Choose the profile field by which the list will be initially ordered. You can still order the list manually by clicking on the headlines in the table view.
The given example will display a list of all users whose profile field "Country" has the value "Deutschland" and will include their avatar, name, phone number, position, branch, country and e-mail.