The Userlister macro displays a list of users registered in Confluence.

Usage

What you need to type

What you will get

{userlister:groups=*}

Parameters

Parameter

Required?

Default

Description

groups

Y

none

Use parameter name 'group' or 'groups'. Specify one or more groups using a comma-separated list of group names. To see all users in all groups, specify an asterisk ('*').

online

N

none

Specify 'true' to generate a list of online users. Specify 'false' to generate a list of offline users.

Examples

Listing all Users

Here is an example that lists all the users registered on your Confluence site.

{userlister:groups=*}
Specifying a Group

Here is an example that lists the users that belong to the group 'my-staff'.

{userlister:groups=my-staff}
Listing Only Online Users

(info) In order to make this feature functional, a System Administrator needs to enable the User Log In Listener for your Confluence site.

Here is an example that lists all currently online users in the 'my-staff' group.

{userlister:groups=my-staff|online=true}
RELATED TOPICS

Working with Macros
Configuring the userlister Macro, in the Administrator's Guide

Take me back to Confluence User Guide