This page last changed on Dec 17, 2009 by ggaskell.

The Spaces List Macro is used to display a list of spaces from within a page.

By default, Confluence lists the spaces from your current view of spaces on the Dashboard.

For each space listed, there is a link to browse the space, and to add a new page (if the user has permission to create pages).

On this page:

Usage with the Macro Browser

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

  1. Open your desired Confluence page or blog post, then click the 'Edit' button. The page or blog post opens in edit mode.
  2. Click the Macro Browser icon on the toolbar. The macro browser window opens in the middle of the screen in 'macro selection' mode.
  3. Scroll through the list of macros. Alternatively, start typing part of the name of your desired macro into the search box at the top right of the macro browser window. Macros with a matching name will appear in the main pane.
  4. Click on the desired macro to access its parameters and preview parameter changes ('preview mode').
  5. Set the macro parameters to your requirements. If desired, you can preview these changes by clicking 'Refresh'.
  6. Click 'Insert' to put the macro into the page.

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


Once you've found the spaces list macro, click 'insert' to add it to your page.

Usage with the Wiki Markup Editor

What you need to type What you will get
{spaces-list}

Application Links 1.x
Documentation for AppLinks version 1.x
Application Links 2.0
Documentation for AppLinks 2.0
Application Links 2.1
Documentation for the latest version of AppLinks
Atlassian Customer Resources
Atlassian Developer Network
For the community of developers modifying and extending JIRA & Confluence.
Atlassian Development
Atlassian Developers. Because they're just too good to be kept hidden in an office in Sydney.
Atlassian Documentation
Information about and links to the Atlassian product documentation, including downloadable documentation
Atlassian Events
Atlassian IDE Connectors
Documentation for the Atlassian Connectors for Eclipse and IntelliJ IDEA
Atlassian Integration Guide
The ways your Atlassian applications work together and how you can make it happen
Atlassian KnowledgeBase
Atlassian Partner Wiki
Atlassian Presentations
Atlassian Training
Atlassian t-shirt Competition
Atlassian User Group
Atlassian User Interface (AUI)
Atlassian Webinars
Bamboo 1.0
Documentation for Bamboo 1.0
Bamboo 1.1
Documentation for Bamboo 1.1
Bamboo 1.2
Documentation for Bamboo 1.2
Bamboo 2.0
Documentation for Bamboo 2.0
Bamboo 2.1
Documentation for Bamboo 2.1
Bamboo 2.2
Documentation for Bamboo 2.2
Bamboo 2.3
Documentation for Bamboo 2.3
Bamboo 2.4
Documentation for Bamboo 2.4
Bamboo 2.5
Documentation for Bamboo 2.5
Bamboo 2.6
Documentation for the latest version of Bamboo
Bamboo Extensions
Bamboo Knowledge Base
Troubleshooting and support tips for Bamboo
Clover 2.0
Documentation for Clover 2.0
Clover 2.1
Documentation for Clover 2.1
Clover 2.3
Documentation for Clover 2.3
Clover 2.4
Documentation for Clover 2.4
Clover 2.5
Documentation for Clover 2.5
Clover 2.6
Documentation for Clover 2.6
Clover 3.0
Documentation for the latest version of Clover
Clover Knowledge Base
Troubleshooting and support tips for Clover
Codegeist
Atlassian's Codegeist! :)
Confluence 1.4 User Guide
User Guide for Confluence 1.4
Confluence 2.0
User Guide for Confluence version 2
Confluence 2.5
Complete documentation for Confluence versions 2.0 to 2.5.3.
Confluence 2.5.6
Complete documentation for Confluence versions 2.5.4 to 2.5.8.
Confluence 2.6
Complete documentation for Confluence version 2.6
Confluence 2.7
Complete documentation for Confluence version 2.7
Confluence 2.8
Complete documentation for Confluence version 2.8
Confluence 2.9
Complete documentation for Confluence version 2.9
Confluence Development
Confluence Docs 2.10
Complete documentation for Confluence version 2.10
Confluence Docs 3.0
Complete documentation for Confluence version 3.0
Confluence Docs 3.1
Complete documentation for Confluence version 3.1
Confluence Docs 3.2
Complete documentation for Confluence version 3.2
Confluence Docs 3.3
Documentation for the latest version of the Confluence wiki: Installation Guide, User Guide, Admin Guide and other techn...
Confluence Evaluator Resources
Confluence Extensions
Confluence Homepage Image
Confluence Hosted Evaluator Resources
Confluence Knowledge Base
Troubleshooting and support tips for Confluence
Confluence SharePoint Connector 1.0
Documentation for version 1.0.x of the Confluence SharePoint Connector.
Confluence SharePoint Connector 1.1
Documentation for version 1.1.x of the Confluence SharePoint Connector.
Confluence SharePoint Connector 1.2
Documentation for the Confluence SharePoint Connector 1.2. This product integrates Confluence with Microsoft SharePoint.
Confluence User Community
This space is for discussing ideas, new features and suggestions for Confluence.
Crowd 1.0
Documentation for Crowd version 1.0.x
Crowd 1.1
Documentation for Crowd version 1.1.x
Crowd 1.2
Documentation for Crowd version 1.2.x
Crowd 1.3
Documentation for Crowd version 1.3.x
Crowd 1.4
Documentation for Crowd version 1.4.x
Crowd 1.5
Documentation for Crowd version 1.5.x
Crowd 1.6
Documentation for Crowd version 1.6.x
Crowd 2.0
Documentation for the latest version of Crowd single signon and identity management
Crowd Development
Crowd Extension
Crowd Knowledge Base
Troubleshooting and support tips for Crowd
Crucible 1.1
Documentation for Crucible 1.1
Crucible 1.2
Documentation for Crucible 1.2
Crucible 1.5
Documentation for Crucible 1.5
Crucible 1.6
Documentation for Crucible 1.6
Crucible 2.0
Documentation for Crucible 2.0
Crucible 2.1
Documentation for Crucible 2.1
Crucible 2.2
Documentation for Crucible 2.2
Crucible 2.3
Latest documentation for Crucible: do your code reviews, your way
Crucible Knowledge Base
Troubleshooting and support tips for Crucible
Demonstration Space
A space which demonstrates Confluence functionality.
Doc Sprint
Enterprise Hosting
Documentation and resources for Enterprise Hosted versions of Confluence and JIRA
Evaluator Resources
FishEye 1.3
Documentation for FishEye 1.3
FishEye 1.4
Documentation for FishEye 1.4
FishEye 1.5
Documentation for FishEye 1.5
FishEye 1.6
Documentation for FishEye 1.6
FishEye 2.0
Documentation for FishEye 2.0
FishEye 2.1
Documentation for FishEye 2.1
FishEye 2.2
Documentation for FishEye 2.2
FishEye 2.3
Latest documentation for FishEye, your view into your source code repository
FishEye and Crucible Development
Tutorials and reference for enhancing and integrating FishEye and Crucible
Fisheye Knowledge Base
Troubleshooting and support tips for Fisheye
Gadget Development
Gadgets and Dashboards 1.0
Documentation for version 1.0.x of Atlassian Gadgets and Dashboards
Gadgets and Dashboards 2.0
Documentation for the latest version of Atlassian Gadgets and Dashboards
GreenHopper 3.8
Documentation archive for GreenHopper 3.8
GreenHopper 4.0
Documentation for GreenHopper 4.0
GreenHopper 4.1
Documentation for GreenHopper 4.1
GreenHopper 4.2
Documentation for GreenHopper 4.2.
GreenHopper 4.3
Documentation for GreenHopper 4.3
GreenHopper 4.4
Documentation for GreenHopper 4.4
GreenHopper 5.0
Documentation for the latest version of GreenHopper.
Greenhopper Knowledge Base
JIRA 3.x Developer Documentation Archive
JIRA 3.x developer documentation archive
JIRA 4.0
Documentation for JIRA 4.0
JIRA 4.1
Documentation for the latest version of JIRA.
JIRA Community Space
JIRA Download Evaluator Resources
JIRA Extensions
JIRA Hosted Evaluator Resources
JIRA Knowledge Base
Troubleshooting and support tips for Jira
JIRA Studio
JIRA Studio Evaluator Resources
Partner Program
Plugin Framework
Documentation for all versions of the Atlassian Plugin Framework.
Plugin Framework 2.0
Documentation for version 2.0 of the Atlassian Plugin Framework.
Plugin Framework 2.1
Documentation for version 2.1 of the Atlassian Plugin Framework.
Plugin Framework 2.2
Documentation for version 2.2 of the Atlassian Plugin Framework.
Plugin Framework 2.3
Documentation for version 2.3 of the Atlassian Plugin Framework.
Shared Access Layer
Documentation for the Atlassian Shared Access Layer (SAL)
Support
Atlassian's legendary support team's projects and policy.
Test space
The Confluence Test Space
This is a space dedicated to testing and playing around with Confluence features. Everyone is invited to experiment.
Universal Plugin Manager 1.0
Documentation for the Universal Plugin Manager 1.0
Universities
User Group Sponsorship

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.
  • team — spaces grouped according to team labels.
  • my — spaces which you have added to your favourites list.
  • 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

Specify the width of the table in which the spaces are listed

{spaces-list:width=40%}

Specify the view from which spaces are listed

{spaces-list:team}

Replace 'team' with 'all', 'my' or 'new' to display all spaces, my spaces only or new spaces only.

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 Jul 09, 2010 01:08