The User List macro displays a list of users registered in Confluence, based on their group membership.
Using the User List macro
To add the User List macro to a page:
Speeding up macro entry with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete. To edit an existing macro: Click the macro placeholder and choose Edit. A macro dialog window will open, where you can edit the parameters of the macro.
On this page:
Related pages:
- Working with Macros
- Configuring the User List Macro Not applicable to Confluence OnDemand.
- Confluence User's Guide
Parameters
Parameters are options that you can set to control the content or format of the macro output.
Parameter | Default | Description |
---|---|---|
Group(s) | none | Specifies one or more groups whose Confluence users you want to list, using a comma-separated list of group names. To see all users registered in a Confluence installation, specify an asterisk ('*') for this parameter's value. |
Display Online/Offline Users | All registered users | Select to generate a list of online users. Clear to generate a list of offline users. In order to make this feature functional, a System Administrator needs to enable the User Log In Listener for your Confluence site. Not applicable to Confluence OnDemand. |
Code examples
See: