This page last changed on Jun 08, 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, then click the 'Edit' button. The 'Edit Page' mode opens.
  2. Next, click the Macro Browser icon on the editor toolbar. The Macro Browser will open in the middle of the screen.
  3. In the Macro Browser, type the name of your desired macro into the search box at the top right of the window. Macros with a matching name will appear in the centre pane. Click on the desired macro to see its options screen. Here, you can set the macro parameters then click 'insert' to put the macro into the page.

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 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 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 Support
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 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 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
Documentation for the latest version of the Confluence wiki: Installation Guide, User Guide, Admin Guide and other techn...
Confluence Extensions
Confluence Homepage Image
Confluence Hosted for Small Business
Documentation and resources for your wiki at Confluence Hosted for Small Business
Confluence Knowledge Base
Troubleshooting and support tips for Confluence
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 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
Latest documentation for Crucible: do your code reviews, your way
Crucible 2.1
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.
Dragon Knowledgebase
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
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
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 Knowledge Base
JIRA 3.x Developer Documentation Archive
JIRA 3.x developer documentation archive
JIRA 4.0
Documentation for JIRA 4.0
JIRA Community Space
JIRA Extensions
JIRA Knowledge Base
Troubleshooting and support tips for Jira
JIRA Studio
Partner Program
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.
Plugin Framework 2.4
Documentation for the latest version of the Atlassian Plugin Framework.
Shared Access Layer
Documentation for the Atlassian Shared Access Layer (SAL)
Summit Planning
Test space
The Confluence Test Space
This is a space dedicated to testing and playing around with Confluence features. Everyone is invited to experiment.
User Group Sponsorship

Parameters

Parameters are settings for Confluence macros that allow the user to control their content or presentation. The table below lists relevant parameters for this macro.

Parameter names are displayed differently in the macro browser interface and in wiki markup. Below, parameter names used in the macro browser are indicated in Bold text, while their equivalents in wiki markup are indicated in (bracketed) text. If the latter is not shown, then in wiki markup, the parameter's name should be omitted and only its value should be added immediately after the colon symbol (:).

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 Guide.

Document generated by Confluence on Dec 10, 2009 18:45