• Products
  • Documentation
  • Resources

Insert the spaces list macro

Use the spaces list macro to display a list of spaces on a page.

To add the spaces list macro:

  1. When editing, select from the toolbar

  2. Find the macro by name and select it

  3. Configure it as needed

You can also type / on the page to bring up the same list you'd see by selecting from the toolbar. Continue typing the name of the macro to filter the list.

To edit the spaces list macro:

  1. Select the macro placeholder.

  2. Select the Edit icon to open the configuration panel.

  3. Configure the parameters. Your changes are saved as you go.

  4. Resume editing the page, and the panel closes.

You can also select the centered , medium-width , and full-width icons to adjust the width of some macros. Select the trashcan iconto remove the macro.

Parameters

Parameters are options that you can set to control what and how content from the macro appears on the page. 

If the parameter name used in Confluence Cloud storage format is different than the label used when inserting macros using the browser or the slash command, it will be listed below in brackets (example).

Parameter

Required?

Default

Description

Scope of spaces

no

all

The view from which spaces are listed. Available options are:

  • (blank) - All spaces in your site, with tabs.

  • all – All spaces in your Confluence site.

  • category – Spaces grouped according to space categories.

  • favorite – Spaces that you have favorited.

  • new – spaces created within the last 7 days.

This parameter is unnamed in storage format.

Width of List
(width

no

100%

The width of the spaces list, specified as a percentage (%) of the window width.

 

 

Still need help?

The Atlassian Community is here for you.