This page last changed on Sep 07, 2011 by pwatson.

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. In the Confluence editor, choose Insert > Other Macros.
  2. Find and select the required macro.

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 AppLinks 3.2
Space: Application Links 3.3
Documentation for AppLinks 3.3
Space: Application Links 3.4
Documentation for AppLinks 3.4
Space: Application Links 3.5
Documentation for the latest version of AppLinks.
Space: Application Links 3.5 Archive
Documentation for AppLinks 3.5
Space: AtlasCamp 2010
Space: AtlasCamp 2011
Space: Atlassian Bonfire
Documentation for the latest version of Bonfire
Space: Atlassian Customer Resources
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.
Space: Atlassian Documentation
Information about and links to the Atlassian product documentation, including downloadable documentation
Space: Atlassian Events
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
Space: Atlassian KnowledgeBase
Space: Atlassian OnDemand
The current documentation for Atlassian OnDemand
Space: Atlassian OnDemand Test Space
Documentation for the current version of JIRA Studio.
Space: Atlassian Partner Wiki
Space: Atlassian Presentations
Space: Atlassian Training
Space: Atlassian Translations
Space: Atlassian t-shirt Competition
Space: Atlassian User Group
Space: Atlassian User Interface (AUI)
Space: Atlassian User Management 1.0
Documentation for version 1.0 of the Atlassian user management interface, as used in Confluence and JIRA.
Space: Atlassian User Management 2.0
Documentation for version 2.0 of the Atlassian user management interface, as used in Confluence and JIRA.
Space: Atlassian User Management 3.0
Documentation for the latest version of the Atlassian user management interface, as used in Confluence and JIRA.
Space: Atlassian Webinars
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
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 Bamboo 3.0
Space: Bamboo 3.1
Documentation for Bamboo 3.1
Space: Bamboo 3.2
Documentation for the latest version of Bamboo
Space: Bamboo Development
Space: Bamboo Extensions
Space: Bamboo Knowledge Base
Troubleshooting and support tips for Bamboo
Space: Bitbucket
Documentation for Atlassian Bitbucket
Space: Bitbucket Knowledge Base
Troubleshooting and support tips for Bitbucket
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 Clover 3.0
Space: Clover 3.1
Documentation for the latest version of Clover
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
Space: Confluence 2.0
User Guide for Confluence version 2
Space: Confluence 2.10
Complete documentation for Confluence version 2.10
Space: Confluence 2.5
Complete documentation for Confluence versions 2.0 to 2.5.3.
Space: Confluence 2.5.6
Complete documentation for Confluence versions 2.5.4 to 2.5.8.
Space: Confluence 2.6
Complete documentation for Confluence version 2.6
Space: Confluence 2.7
Complete documentation for Confluence version 2.7
Space: Confluence 2.8
Complete documentation for Confluence version 2.8
Space: Confluence 2.9
Complete documentation for Confluence version 2.9
Space: Confluence 3.0
Complete documentation for Confluence version 3.0
Space: Confluence 3.1
Complete documentation for Confluence version 3.1
Space: Confluence 3.2
Complete documentation for Confluence version 3.2
Space: Confluence 3.3
Complete documentation for Confluence version 3.3
Space: Confluence 3.4
Complete documentation for Confluence version 3.4
Space: Confluence 3.5
Complete documentation for Confluence version 3.5
Space: Confluence 4.0
Documentation for the latest version of the Confluence wiki: Installation Guide, User Guide, Admin Guide and other techn...
Space: Confluence Development
Space: Confluence Evaluator Resources
Space: Confluence Extensions
Space: Confluence Homepage Image
Space: Confluence Hosted Evaluator Resources
Space: Confluence Knowledge Base
Troubleshooting and support tips for Confluence
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.
Space: Confluence SharePoint Connector 1.4
Documentation for the Confluence SharePoint Connector 1.4. This product integrates Confluence with Microsoft SharePoint.
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 Crowd version 2.2.x
Space: Crowd 2.3
Documentation for the latest version of Crowd single signon and identity management
Space: Crowd Development
Space: Crowd Extension
Space: Crowd Knowledge Base
Troubleshooting and support tips for Crowd
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
Documentation for Crucible 2.5
Space: Crucible 2.6
Documentation for Crucible 2.6
Space: Crucible 2.7
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.
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
Documentation for FishEye 2.5
Space: FishEye 2.6
Documentation for FishEye 2.5
Space: FishEye 2.7
Latest documentation for FishEye, your view into your source code repository
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
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
Space: GreenHopper 3.8
Documentation archive for GreenHopper 3.8
Space: GreenHopper 4.0
Documentation for GreenHopper 4.0
Space: GreenHopper 4.1
Documentation for GreenHopper 4.1
Space: GreenHopper 4.2
Documentation for GreenHopper 4.2.
Space: GreenHopper 4.3
Documentation for GreenHopper 4.3
Space: GreenHopper 4.4
Documentation for GreenHopper 4.4
Space: GreenHopper 5.0
Documentation for GreenHopper 5.0
Space: GreenHopper 5.1
Documentation for GreenHopper 5.1
Space: GreenHopper 5.2
Documentation for GreenHopper 5.2
Space: GreenHopper 5.3
Documentation for GreenHopper 5.3
Space: GreenHopper 5.4
Documentation for GreenHopper 5.4
Space: GreenHopper 5.5
Documentation for GreenHopper 5.5
Space: GreenHopper 5.6
Documentation for GreenHopper 5.6.
Space: GreenHopper 5.7
Documentation for the latest version of GreenHopper.
Space: GreenHopper Development
Space: GreenHopper Knowledge Base
Space: Integrating with JIRA
Documentation for the latest version of the JIRA integration interface
Space: JIRA 3.x Developer Documentation Archive
JIRA 3.x developer documentation archive
Space: JIRA 4.0
Documentation for JIRA 4.0
Space: JIRA 4.1
Documentation for JIRA 4.1
Space: JIRA 4.2
Documentation for JIRA 4.2
Space: JIRA 4.3
Documentation for JIRA 4.3
Space: JIRA 4.4
Documentation for JIRA 4.4
Space: JIRA Community Space
Space: JIRA Development
Space: JIRA Download Evaluator Resources
Space: JIRA Extensions
Space: JIRA Hosted Evaluator Resources
Space: JIRA in JIRA Studio
Documentation for JIRA 4.4
Space: JIRA Knowledge Base
Troubleshooting and support tips for Jira
Space: JIRA Mobile Connect
Space: JIRA Staging
Documentation for JIRA 4.4
Space: JIRA Studio
Documentation for the current version of JIRA Studio.
Space: JIRA Studio Evaluator Resources
Space: Plugin Framework
Documentation for all versions of the Atlassian Plugin Framework
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 Speaker Guidelines
Space: Summit 2011 Sponsorship
Learn about becoming a sponsor for Atlassian Summit 2011
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"
Space: Team Calendars
Documentation for Team Calendars for Confluence, where people, projects and content meet.
Space: Test space
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.
Space: Universal Plugin Manager 1.0
Documentation for the Universal Plugin Manager 1.0
Space: Universal Plugin Manager 1.2
Documentation for the Universal Plugin Manager 1.2
Space: Universal Plugin Manager 1.3
Documentation for the Universal Plugin Manager 1.3
Space: Universal Plugin Manager 1.4
Documentation for the Universal Plugin Manager 1.4
Space: Universal Plugin Manager 1.5
Documentation for the Universal Plugin Manager 1.5
Space: Universal Plugin Manager 1.5 Archive
Documentation for the Universal Plugin Manager 1.5
Space: Universities
Space: User Group Sponsorship

Parameters

When editing, you can click on the macro placeholder and choose Edit to display the parameters for this macro in the Macro Browser.

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

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 Page
Working with Macros

Take me back to the Confluence User's Guide

Document generated by Confluence on Sep 19, 2011 02:36