With RefinedTheme you can associate users to categories to show you organisation (learn more: Category Users and Space Users). This macro display users and category roles assigned to a category.

On this page



Macro Setup

Users in category

Macro key: rw-users-category

Macro body: None.

Promoted: Category Dashboards.


 

Using the Users In Category macro

To add the Users In Category macro to a page

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


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


Leverage the power of Layout placeholders

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


Learn more about associating Users to Categories here: Connecting Users to Categories and Spaces


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 wikimarkup 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)

{Category Name} The title of the macro.

4.2

Description

(description)

 A description.4.2

Category key

(categoryKey)

 
Specify the category key to show users and roles from a category.
Note that this is automatically done if the macro is placed on a category dashboard.
4.2

Layout

(layout)

avatar_name

list - displays the users with avatar and name

avatar - displays the users with an avatar

4.2

Size

(size)

small

small - set the avatar size to small

large - set the avatar size to large

4.2

Roles only

(rolesOnly)

 
When checked, display the category users that has specified roles for this category. 
4.2

Users in hierarchy

(hierarchy)

no_hierarchy

no_hierarchy - only shows category users from the specific category

tree_view - shows category users from subcategories

tree_view_closed - shows category users from subcategories in a collapsed tree

Display users assigned to subcategories in an hierarchy. Options: no_hierarchy, tree_view and tree_view_closed

4.2
Max results
Determines the maximum number of users presented. Please note this macro caps out at 200 users.

Demo