Presents a list of users specified by user groups or usernames with the ability to change the presentation layout.

On this page



Macro Setup

Users

Macro key: rw-users

Macro body: None

Promoted: Main dashboard


 

Using the Users macro

To add the Users macro to a page

  1. In the Confluence editor, choose Insert > Other Macros.
  2. Find and select the Users macro.


For Site and Category homes we recommend using the Users Module.


Leverage the power of Layout placeholders

The parameters of the Users Macro works great with Layout Placeholders if the macro is placed on a dashboard or space layout.


Preview


Parameters

Parameters are options that you can set to control the content or format of the macro output. When the parameter name used in Confluence storage format or wiki markup is different to the label used in the macro browser, it will be listed below in brackets (example).

Parameter

Default

Description

Available since

Title

(title)

 Add a title to the macro4.0.1

Users

(users)

 

A list of users to include, separated by comma.

4.0.1

User groups

(groups)

 A list of user groups to include, separated by comma. 

Layout

(layout)

avatar

avatar - show the avatar of the specified users

simple - show the avatar and the name of the specified users

full - show full information about the specified users

list - show the specified users in a list

4.0.1

Description

(description)

 A description.4.0.1

Exclude category membership

(excludeUserCategories)

false
When checked, excludes links to categories where the user is a member. By default, these categories are displayed. Category membership is only visible in combination with the 'full' layout
4.2

 

Demo