With Refined, you can connect users to categories and spaces. The Users in Space macro displays users connected to the space. For example, on an intranet you can show which users work in the IT team and which roles they have. To add users to a space, you need to use the Confluence permission scheme.
This macro is not related to space permissions. It is simply a way of displaying users who are organisationally connected to the space, 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 |
|---|---|---|
Title | The macro’s title. | 4.2 |
Description | A text, for example to explain more about the space or the users. | 4.2 |
Space key | Specify a space key to show users and roles from that category. You will not need to do this if the macro is placed in the space layout editor or any page in the space. It is not possible to use a personal space key. | 4.2 |
Users from category | Select to show users from this space's parent category. This will override the space key settings. | |
Layout |
| 4.2 |
Size | Avatar size: small or large. | 4.2 |
Roles only | Select to display only the space users that have a specified role in this space. | 4.2 |
Macro key
Macro keys are used to identify macros in the macro browser and to build custom solutions. The Users in Space macro key is rw-users-space.