Spaces List Macro
Add the Spaces List macro to a page to display a list of spaces on a page.
This is legacy macro. It was previously used in the dashboard, and has been known to cause issues large sites. Although limited, this macro is great if you want to:
- highlight spaces that have been created in the last 7 days
- provide a list of spaces, that can be filtered by space category.
Screenshot: Page with a Spaces List macro showing cross-team spaces.
This macro works best with space categories. See Use Labels to Categorize Spaces to find out how to categorize spaces in your site.
Add this macro to your page
To add the Spaces List macro to a page:
- Unable to render {include} The included page could not be found.
- Choose Spaces List from the Confluence content category.
- Enter any parameters.
- Choose Insert.
You can then publish your page to see the macro in action.
Screenshot: Configuring the spaces list macro to show spaces by category.
Change the macro parameters
Error rendering macro 'excerpt-include'
User 'null' does not have permission to view the page.
Here's a list of the parameters available in this macro.
Parameter | Required? | Default | Description |
|---|---|---|---|
Scope of spaces | no | all | The view from which spaces are listed. Available options are:
This parameter is unnamed in wiki markup and storage format. |
Width of List | no | 100% | The width of the spaces list, specified as a percentage (%) of the window width. |
Include archived spaces | no | False | Include spaces that have been archived in the list. These are excluded by default. |
Error rendering macro 'excerpt-include'
User 'null' does not have permission to view the page.
Troubleshooting
This macro is known to cause issues in sites with large number of spaces. See CONFSERVER-59804 - Getting issue details... STATUS .
This macro is provided by the Dashboard Macros system app. Disable the Spaces module if you want to prevent people using this macro.
Other ways to add this macro
Add this macro as you type
Add this macro using wiki markup
Macro name: spaces
Macro body: None.
{spaces:favourite|width=80%}