This page last changed on Feb 26, 2011 by smaddox.

The Spaces List Macro is used to display a list of spaces from within a page, similar to the list of spaces seen on the dashboard.

Usage with the Macro Browser

To insert the spaces list macro into a page using the Macro Browser:

  1. Open the Confluence page or blog post that you want to edit, then click the 'Edit' button.
  2. Click the Macro Browser icon on the toolbar. The macro browser window will open.
  3. Scroll through the list of macros to find the one you want. Alternatively, start typing the macro name into the search box at the top right of the macro browser. Macros with a matching name will appear in the main pane.
  4. Click the desired macro.
  5. Set the macro parameters to your requirements. If desired, you can preview these changes by clicking 'Refresh'.
  6. Click 'Insert' to add the macro onto the page.

You can also insert macros via autocomplete. For more information, see Using Autocomplete in the Rich Text Editor.

Usage with the Wiki Markup Editor

What you need to type What you will get
{spaces}
or
{spaces-list}
Space: Application Links 1.x
Documentation for AppLinks version 1.x
Space: Application Links 2.0
Documentation for AppLinks 2.0
Space: Application Links 2.1
Documentation for AppLinks 2.1
Space: Application Links 3.0
Documentation for AppLinks 3.0
Space: Application Links 3.2
Documentation for the latest version of AppLinks.
Space: AtlasCamp 2010
Browse the "ATL" space You don't have permission to add pages to "ATL" Add "ATL" to your favourites
Space: Atlassian Customer Resources
Browse the "CUST" space You don't have permission to add pages to "CUST" Add "CUST" to your favourites
Space: Atlassian Developer Network
For the community of developers modifying and extending Atlassian products.
Space: Atlassian Development
Atlassian Developers. Because they're just too good to be kept hidden in an office in Sydney.
Browse the "DEV" space You don't have permission to add pages to "DEV" Add "DEV" to your favourites
Space: Atlassian Documentation
Information about and links to the Atlassian product documentation, including downloadable documentation
Browse the "ALLDOC" space You don't have permission to add pages to "ALLDOC" Add "ALLDOC" to your favourites
Space: Atlassian Events
Browse the "EVENTS" space You don't have permission to add pages to "EVENTS" Add "EVENTS" to your favourites
Space: Atlassian IDE Connectors
Documentation for the Atlassian Connectors for Eclipse and IntelliJ IDEA
Space: Atlassian Integration Guide
The ways your Atlassian applications work together and how you can make it happen
Browse the "ATLAS" space You don't have permission to add pages to "ATLAS" Add "ATLAS" to your favourites
Space: Atlassian KnowledgeBase
Browse the "KB" space You don't have permission to add pages to "KB" Add "KB" to your favourites
Space: Atlassian Partner Wiki
Browse the "APW" space You don't have permission to add pages to "APW" Add "APW" to your favourites
Space: Atlassian Presentations
Browse the "ATLP" space You don't have permission to add pages to "ATLP" Add "ATLP" to your favourites
Space: Atlassian Training
Space: Atlassian t-shirt Competition
Browse the "tshirt" space You don't have permission to add pages to "tshirt" Add "tshirt" to your favourites
Space: Atlassian User Group
Space: Atlassian User Interface (AUI)
Space: Atlassian User Management 1.0
Documentation for the latest version of the Atlassian user management interface, as used in Confluence and JIRA.
Browse the "USERMAN" space You don't have permission to add pages to "USERMAN" Add "USERMAN" to your favourites
Space: Atlassian Webinars
Browse the "WEBINAR" space You don't have permission to add pages to "WEBINAR" Add "WEBINAR" to your favourites
Space: Bamboo 1.0
Documentation for Bamboo 1.0
Space: Bamboo 1.1
Documentation for Bamboo 1.1
Space: Bamboo 1.2
Documentation for Bamboo 1.2
Space: Bamboo 2.0
Documentation for Bamboo 2.0
Space: Bamboo 2.1
Documentation for Bamboo 2.1
Space: Bamboo 2.2
Documentation for Bamboo 2.2
Space: Bamboo 2.3
Documentation for Bamboo 2.3
Space: Bamboo 2.4
Documentation for Bamboo 2.4
Space: Bamboo 2.5
Documentation for Bamboo 2.5
Space: Bamboo 2.6
Documentation for Bamboo 2.6
Space: Bamboo 2.7 Archive
Documentation for Bamboo 2.7
Space: Bamboo 2.7 Archive Backup
Archived Documentation for Bamboo 2.7 (supersedes BAMBOO027 space)
Space: Bamboo 3.0
Documentation for the latest version of Bamboo
Browse the "BAMBOO" space You don't have permission to add pages to "BAMBOO" Add "BAMBOO" to your favourites
Space: Bamboo Extensions
Browse the "BAMEXT" space You don't have permission to add pages to "BAMEXT" Add "BAMEXT" to your favourites
Space: Bamboo Knowledge Base
Troubleshooting and support tips for Bamboo
Browse the "BAMKB" space You don't have permission to add pages to "BAMKB" Add "BAMKB" to your favourites
Space: Bitbucket
Documentation for Atlassian Bitbucket
Space: Bitbucket Development
API and developer documentation for Bitbucket.
Space: Bitbucket Knowledge Base
Troubleshooting and support tips for Bitbucket
Browse the "BBKB" space You don't have permission to add pages to "BBKB" Add "BBKB" to your favourites
Space: Clover 2.0
Documentation for Clover 2.0
Space: Clover 2.1
Documentation for Clover 2.1
Space: Clover 2.3
Documentation for Clover 2.3
Space: Clover 2.4
Documentation for Clover 2.4
Space: Clover 2.5
Documentation for Clover 2.5
Space: Clover 2.6
Documentation for Clover 2.6
Space: Clover 3.0
Documentation for the latest version of Clover
Browse the "CLOVER" space You don't have permission to add pages to "CLOVER" Add "CLOVER" to your favourites
Space: Clover Knowledge Base
Troubleshooting and support tips for Clover
Space: Codegeist
Atlassian's Codegeist! :)
Space: Confluence 1.4 User Guide
User Guide for Confluence 1.4
Browse the "CONF14" space You don't have permission to add pages to "CONF14" Add "CONF14" to your favourites
Space: Confluence 2.0
User Guide for Confluence version 2
Browse the "CONF20" space You don't have permission to add pages to "CONF20" Add "CONF20" to your favourites
Space: Confluence 2.10
Complete documentation for Confluence version 2.10
Browse the "CONF210" space You don't have permission to add pages to "CONF210" Add "CONF210" to your favourites
Space: Confluence 2.5
Complete documentation for Confluence versions 2.0 to 2.5.3.
Browse the "CONF25" space You don't have permission to add pages to "CONF25" Add "CONF25" to your favourites
Space: Confluence 2.5.6
Complete documentation for Confluence versions 2.5.4 to 2.5.8.
Browse the "CONF256" space You don't have permission to add pages to "CONF256" Add "CONF256" to your favourites
Space: Confluence 2.6
Complete documentation for Confluence version 2.6
Browse the "CONF26" space You don't have permission to add pages to "CONF26" Add "CONF26" to your favourites
Space: Confluence 2.7
Complete documentation for Confluence version 2.7
Browse the "CONF27" space You don't have permission to add pages to "CONF27" Add "CONF27" to your favourites
Space: Confluence 2.8
Complete documentation for Confluence version 2.8
Browse the "CONF28" space You don't have permission to add pages to "CONF28" Add "CONF28" to your favourites
Space: Confluence 2.9
Complete documentation for Confluence version 2.9
Browse the "CONF29" space You don't have permission to add pages to "CONF29" Add "CONF29" to your favourites
Space: Confluence 3.0
Complete documentation for Confluence version 3.0
Browse the "CONF30" space You don't have permission to add pages to "CONF30" Add "CONF30" to your favourites
Space: Confluence 3.1
Complete documentation for Confluence version 3.1
Browse the "CONF31" space You don't have permission to add pages to "CONF31" Add "CONF31" to your favourites
Space: Confluence 3.2
Complete documentation for Confluence version 3.2
Browse the "CONF32" space You don't have permission to add pages to "CONF32" Add "CONF32" to your favourites
Space: Confluence 3.3
Complete documentation for Confluence version 3.3
Browse the "CONF33" space You don't have permission to add pages to "CONF33" Add "CONF33" to your favourites
Space: Confluence 3.4
Complete documentation for Confluence version 3.4
Browse the "CONF34" space You don't have permission to add pages to "CONF34" Add "CONF34" to your favourites
Space: Confluence 3.5
Documentation for the latest version of the Confluence wiki: Installation Guide, User Guide, Admin Guide and other techn...
Browse the "DOC" space You don't have permission to add pages to "DOC" Add "DOC" to your favourites
Space: Confluence Development
Space: Confluence Evaluator Resources
Space: Confluence Extensions
Browse the "CONFEXT" space You don't have permission to add pages to "CONFEXT" Add "CONFEXT" to your favourites
Space: Confluence Homepage Image
Browse the "ConHome" space You don't have permission to add pages to "ConHome" Add "ConHome" to your favourites
Space: Confluence Hosted Evaluator Resources
Space: Confluence Knowledge Base
Troubleshooting and support tips for Confluence
Browse the "CONFKB" space You don't have permission to add pages to "CONFKB" Add "CONFKB" to your favourites
Space: Confluence SharePoint Connector 1.0
Documentation for version 1.0.x of the Confluence SharePoint Connector.
Space: Confluence SharePoint Connector 1.1
Documentation for version 1.1.x of the Confluence SharePoint Connector.
Space: Confluence SharePoint Connector 1.2
Documentation for the Confluence SharePoint Connector 1.2. This product integrates Confluence with Microsoft SharePoint.
Space: Confluence SharePoint Connector 1.3
Documentation for the Confluence SharePoint Connector 1.3. This product integrates Confluence with Microsoft SharePoint.
Browse the "SPCON" space You don't have permission to add pages to "SPCON" Add "SPCON" to your favourites
Space: Confluence User Community
This space is for discussing ideas, new features and suggestions for Confluence.
Space: Crowd 1.0
Documentation for Crowd version 1.0.x
Space: Crowd 1.1
Documentation for Crowd version 1.1.x
Space: Crowd 1.2
Documentation for Crowd version 1.2.x
Space: Crowd 1.3
Documentation for Crowd version 1.3.x
Space: Crowd 1.4
Documentation for Crowd version 1.4.x
Space: Crowd 1.5
Documentation for Crowd version 1.5.x
Space: Crowd 1.6
Documentation for Crowd version 1.6.x
Space: Crowd 2.0
Documentation for Crowd version 2.0.x
Space: Crowd 2.1
Documentation for Crowd version 2.1.x
Space: Crowd 2.2
Documentation for the latest version of Crowd single signon and identity management
Browse the "CROWD" space You don't have permission to add pages to "CROWD" Add "CROWD" to your favourites
Space: Crowd Development
Space: Crowd Extension
Space: Crowd Knowledge Base
Troubleshooting and support tips for Crowd
Browse the "CROWDKB" space You don't have permission to add pages to "CROWDKB" Add "CROWDKB" to your favourites
Space: Crucible 1.1
Documentation for Crucible 1.1
Space: Crucible 1.2
Documentation for Crucible 1.2
Space: Crucible 1.5
Documentation for Crucible 1.5
Space: Crucible 1.6
Documentation for Crucible 1.6
Space: Crucible 2.0
Documentation for Crucible 2.0
Space: Crucible 2.1
Documentation for Crucible 2.1
Space: Crucible 2.2
Documentation for Crucible 2.2
Space: Crucible 2.3
Documentation for Crucible 2.3
Space: Crucible 2.4
Documentation for Crucible 2.4
Space: Crucible 2.5
Latest documentation for Crucible: do your code reviews, your way
Space: Crucible Knowledge Base
Troubleshooting and support tips for Crucible
Space: Demonstration Space
A space which demonstrates Confluence functionality.
Browse the "ds" space You don't have permission to add pages to "ds" Add "ds" to your favourites
Space: Doc Sprint
Space: Enterprise Hosting
Documentation and resources for Enterprise Hosted versions of Confluence and JIRA
Space: Evaluator Resources
Space: FishEye 1.3
Documentation for FishEye 1.3
Space: FishEye 1.4
Documentation for FishEye 1.4
Space: FishEye 1.5
Documentation for FishEye 1.5
Space: FishEye 1.6
Documentation for FishEye 1.6
Space: FishEye 2.0
Documentation for FishEye 2.0
Space: FishEye 2.1
Documentation for FishEye 2.1
Space: FishEye 2.2
Documentation for FishEye 2.2
Space: FishEye 2.3
Documentation for FishEye 2.3
Space: FishEye 2.4
Documentation for FishEye 2.4
Space: FishEye 2.5
Latest documentation for FishEye, your view into your source code repository
Browse the "FISHEYE" space You don't have permission to add pages to "FISHEYE" Add "FISHEYE" to your favourites
Space: FishEye and Crucible Development
Tutorials and reference for enhancing and integrating FishEye and Crucible
Space: Fisheye Knowledge Base
Troubleshooting and support tips for Fisheye
Browse the "FISHKB" space You don't have permission to add pages to "FISHKB" Add "FISHKB" to your favourites
Space: Gadget Development
Space: Gadgets and Dashboards 1.0
Documentation for version 1.0.x of Atlassian Gadgets and Dashboards
Space: Gadgets and Dashboards 2.0
Documentation for version 2.0.x of Atlassian Gadgets and Dashboards
Space: Gadgets and Dashboards 3.0
Documentation for the latest version of Atlassian Gadgets and Dashboards
Browse the "GADGETS" space You don't have permission to add pages to "GADGETS" Add "GADGETS" to your favourites
Space: GreenHopper 3.8
Documentation archive for GreenHopper 3.8
Browse the "GH038" space You don't have permission to add pages to "GH038" Add "GH038" to your favourites
Space: GreenHopper 4.0
Documentation for GreenHopper 4.0
Browse the "GH040" space You don't have permission to add pages to "GH040" Add "GH040" to your favourites
Space: GreenHopper 4.1
Documentation for GreenHopper 4.1
Browse the "GH041" space You don't have permission to add pages to "GH041" Add "GH041" to your favourites
Space: GreenHopper 4.2
Documentation for GreenHopper 4.2.
Browse the "GH042" space You don't have permission to add pages to "GH042" Add "GH042" to your favourites
Space: GreenHopper 4.3
Documentation for GreenHopper 4.3
Browse the "GH043" space You don't have permission to add pages to "GH043" Add "GH043" to your favourites
Space: GreenHopper 4.4
Documentation for GreenHopper 4.4
Browse the "GH044" space You don't have permission to add pages to "GH044" Add "GH044" to your favourites
Space: GreenHopper 5.0
Documentation for GreenHopper 5.0
Browse the "GH050" space You don't have permission to add pages to "GH050" Add "GH050" to your favourites
Space: GreenHopper 5.1
Documentation for GreenHopper 5.1
Browse the "GH051" space You don't have permission to add pages to "GH051" Add "GH051" to your favourites
Space: GreenHopper 5.2
Documentation for GreenHopper 5.2
Browse the "GH052" space You don't have permission to add pages to "GH052" Add "GH052" to your favourites
Space: GreenHopper 5.3
Documentation for GreenHopper 5.3
Browse the "GH053" space You don't have permission to add pages to "GH053" Add "GH053" to your favourites
Space: GreenHopper 5.4
Documentation GreenHopper 5.4.
Browse the "GH054" space You don't have permission to add pages to "GH054" Add "GH054" to your favourites
Space: GreenHopper 5.5
Documentation for the latest version of GreenHopper.
Browse the "GH" space You don't have permission to add pages to "GH" Add "GH" to your favourites
Space: GreenHopper Knowledge Base
Browse the "GHKB" space You don't have permission to add pages to "GHKB" Add "GHKB" to your favourites
Space: JIRA 3.x Developer Documentation Archive
JIRA 3.x developer documentation archive
Browse the "JIRA03x" space You don't have permission to add pages to "JIRA03x" Add "JIRA03x" to your favourites
Space: JIRA 4.0
Documentation for JIRA 4.0
Browse the "JIRA040" space You don't have permission to add pages to "JIRA040" Add "JIRA040" to your favourites
Space: JIRA 4.1
Documentation for JIRA 4.1
Browse the "JIRA041" space You don't have permission to add pages to "JIRA041" Add "JIRA041" to your favourites
Space: JIRA 4.2
Documentation for JIRA 4.2
Browse the "JIRA042" space You don't have permission to add pages to "JIRA042" Add "JIRA042" to your favourites
Space: JIRA 4.3
Documentation for the latest version of JIRA.
Browse the "JIRA" space You don't have permission to add pages to "JIRA" Add "JIRA" to your favourites
Space: JIRA Community Space
Space: JIRA Download Evaluator Resources
Browse the "JIRADL" space You don't have permission to add pages to "JIRADL" Add "JIRADL" to your favourites
Space: JIRA Extensions
Browse the "JIRAEXT" space You don't have permission to add pages to "JIRAEXT" Add "JIRAEXT" to your favourites
Space: JIRA Hosted Evaluator Resources
Space: JIRA Knowledge Base
Troubleshooting and support tips for Jira
Browse the "JIRAKB" space You don't have permission to add pages to "JIRAKB" Add "JIRAKB" to your favourites
Space: JIRA Studio
Documentation for the current version of JIRA Studio.
Space: JIRA Studio Evaluator Resources
Space: Partner Program
Space: Plugin Development Platform
Documentation for all versions of the Atlassian Development Platform.
Space: Plugin Framework 2.0
Documentation for version 2.0 of the Atlassian Plugin Framework.
Space: Plugin Framework 2.1
Documentation for version 2.1 of the Atlassian Plugin Framework.
Space: Plugin Framework 2.2
Documentation for version 2.2 of the Atlassian Plugin Framework.
Space: Plugin Framework 2.3
Documentation for version 2.3 of the Atlassian Plugin Framework.
Space: REST APIs
Space: Security
Security documentation starting point
Space: Shared Access Layer
Documentation for the Atlassian Shared Access Layer (SAL)
Space: Summit 2011 Sponsorship
Learn about becoming a sponsor for Atlassian Summit 2011
Browse the "SMT11" space You don't have permission to add pages to "SMT11" Add "SMT11" to your favourites
Space: Support
Atlassian's legendary support team's projects and policy.
Browse the "Support" space You don't have permission to add pages to "Support" Add "Support" to your favourites
Space: Test space
Browse the "TESTRSS" space You don't have permission to add pages to "TESTRSS" Add "TESTRSS" to your favourites
Space: Test Space
Space: The Confluence Test Space
This is a space dedicated to testing and playing around with Confluence features. Everyone is invited to experiment.
Browse the "TESTING" space You don't have permission to add pages to "TESTING" Add "TESTING" to your favourites
Space: Universal Plugin Manager 1.0
Documentation for the Universal Plugin Manager 1.0
Browse the "UPM010" space You don't have permission to add pages to "UPM010" Add "UPM010" to your favourites
Space: Universal Plugin Manager 1.2
Documentation for the Universal Plugin Manager 1.2
Browse the "UPM012" space You don't have permission to add pages to "UPM012" Add "UPM012" to your favourites
Space: Universal Plugin Manager 1.3
Documentation for the Universal Plugin Manager 1.3
Browse the "UPM" space You don't have permission to add pages to "UPM" Add "UPM" to your favourites
Space: Universities
Browse the "UNI" space You don't have permission to add pages to "UNI" Add "UNI" to your favourites
Space: User Group Sponsorship
Browse the "UGS" space You don't have permission to add pages to "UGS" Add "UGS" to your favourites

Parameters

Parameters are options that you can include in Confluence macros to control the content or format of the macro output. The table below lists relevant parameters for this macro.

Parameter names are different in the macro browser and in wiki markup. Below we show the macro browser parameter names in bold text, and the equivalent wiki markup parameters in (bracketed) text. If we do not show any parameter name for the wiki markup, then you should leave out the parameter name and simply include the parameter value as the first parameter, immediately after the colon (:).

Parameter Required? Default Description
Scope of spaces no all Specify the view from which spaces are listed. Available options are:
  • all – All spaces in the Confluence installation.
  • category – Spaces grouped according to space categories.
  • team – Same as 'category' above. Space categories were formerly known as team labels, and this option remains in the macro to ensure backwards compatibility with earlier versions of the macro.
  • favourite – Spaces which you have added to your favourites list.
  • my – Same as 'favourite' above. This option remains in the macro to ensure backwards compatibility with earlier versions of the macro.
  • new – New spaces which have been created within the last 7 days.
Width of List
(width)
no 100% Specify the width of the table. The width of the spaces list table, specified as a percentage (%).

Examples

Display the spaces in a table with a width of 40% of the window size:

{spaces:width=40%}

Display the spaces grouped by space category:

{spaces:team}
RELATED TOPICS

Browsing a space
Creating a New Page
Working with Macros

Take me back to the Confluence User's Guide

Document generated by Confluence on Mar 16, 2011 18:24