Users in Category macro

With Refined, you can Connect users to categories and spaces. The Users in Category macro displays users that are connected to a category. For example, on an intranet you can use it to show which users work on an HR project and which roles they have.

This macro is not related to category permissions. It is simply a way of displaying users who are organisationally connected to the category, for example to let users know who to contact.

Add and edit the macro

You can add macros to pages, user dashboards, and space layouts.

To change its settings, click the macro > Edit.

Parameter	Description	Available since

Parameter	Description	Available since
Title	The macro’s title.	4.2
Description	A text, for example to explain more about the category or the users.	4.2
Category key	Specify a category key to show users and roles from that category. You will not need to do this if the macro is placed on a category dashboard.	4.2
Layout	List shows the users with avatar and name. Avatar shows the users with an avatar.	4.2
Size	Avatar size: small or large.	4.2
Roles only	Select to show only the category users that have a specified role in this category.	4.2
Users in hierarchy	Show users assigned to subcategories in an 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.	4.2
Max results	Determine the maximum number of users in the macro (up to 200).

Macro key

Macro keys are used to identify macros in the macro browser and to build custom solutions. The Users in Category macro key is rw-users-category.