.png)
The {spaces} macro displays a list of spaces, similar to that on the dashboard...
Overview
This macro displays a tabbed list of spaces, or just the contents one specified tab, similar to that seen on The Dashboard and is ideal for creating Custom Dashboards.
Note: End-user instructions for interacting with the macro are shown in our Spaces tutorial.
Parameters
{spaces:tab|width=w}
The following parameters are available:
| Parameter | Required | Default | Notes |
|---|---|---|---|
| default |  |
all | Optionally filter the spaces list to the contents of a specific tab:
|
| width | |
100% | Defines the width of the spaces list in either pixels (eg. 500px) or as a percentage of the page width (eg. 90%). |
Examples
To display the default tabbed spaces list on screen, use the following:
{spaces}Which results in:
Spaces:- All
Adaptavist - Atlassian consultants specialising in Confluence and JIRA plugins, training, hosting and support services Adaptavist are Atlassian Partner and global experts in consultancy, plugin development, training and support services fo...
Adaptavist - Atlassian Experts in Consultancy, Plugins, Hosting, Training and Support for Confluence, JIRA and Crowd and More Atlassian Confluence Wiki Atlassian's Confluence Enterprise wiki documentationAtlassian Support Services - JIRA support, Confluence support and other Atlassian services Adaptavist provide a wide range of support services from free Community support to missioncritical 24/7 Enterprise servi...Atlassian Training Services - JIRA training, Confluence training and other Atlassian training services and courses Adaptavist provide online and onsite training for Atlassian products and plugins.Community Bubbles Plugin Tutorials, forum, support and more for our Community Bubbles plugin which adds social networking, communities, forums an...Confluence, JIRA and other Atlassian Product Consulting and Best Practice Our bespoke solutions can be tailored to your exact needs. Services include plugin development, Confluence Health Check,...Confluence Consulting from Adaptavist Confluence Plugins and Macros for your Atlassian Wiki Information and documentation about Adaptavist's range of Confluence Plugins and Plugin Packs.Confluence Plugins Community - Add questions, answers, ideas, bugs and improvements related to our plugins and Atlassian software Environment Find out what Adaptavist are doing to protect the environment.Flickr An example of a Flickr like wiki theme developed with Theme BuilderFree Plugins Adaptavist regularly release projects as open source, licensed as BSD, ASL2 or MIT. We don't believe in, and will never ...JIRA hosting, Confluence hosting and other Atlassian hosting services - dedicated and shared solutions Starter, dedicated and remote hosting services for Confluence, JIRA and all other Atlassian products.Plugin Labs - Confluence and JIRA plugins, developments and ideas that extend Atlassian software Public Resources This space contains several resources (eg. images, logos) that are used throughout our site. It's easier to keep them in...Scriptix Plugin Scriptix is a Confluence plugin that enables you to quickly create powerful macros, actions, servlets and much more usin...Services Theme Builder Plugin Tutorials, forum, support and more for our Theme Builder plugin, which is used to customise Confluence.wikipedia An example of a Wikipedialike wiki theme developed using Theme Builder.You can optionally set the width as follows:
{spaces:width=50%}Which results in:
Spaces:- All
Adaptavist - Atlassian consultants specialising in Confluence and JIRA plugins, training, hosting and support services Adaptavist are Atlassian Partner and global experts in consultancy, plugin development, training and support services fo...Adaptavist - Atlassian Experts in Consultancy, Plugins, Hosting, Training and Support for Confluence, JIRA and Crowd and More Atlassian Confluence Wiki Atlassian's Confluence Enterprise wiki documentationAtlassian Support Services - JIRA support, Confluence support and other Atlassian services Adaptavist provide a wide range of support services from free Community support to missioncritical 24/7 Enterprise servi...Atlassian Training Services - JIRA training, Confluence training and other Atlassian training services and courses Adaptavist provide online and onsite training for Atlassian products and plugins.Community Bubbles Plugin Tutorials, forum, support and more for our Community Bubbles plugin which adds social networking, communities, forums an...Confluence, JIRA and other Atlassian Product Consulting and Best Practice Our bespoke solutions can be tailored to your exact needs. Services include plugin development, Confluence Health Check,...Confluence Consulting from Adaptavist Confluence Plugins and Macros for your Atlassian Wiki Information and documentation about Adaptavist's range of Confluence Plugins and Plugin Packs.Confluence Plugins Community - Add questions, answers, ideas, bugs and improvements related to our plugins and Atlassian software Environment Find out what Adaptavist are doing to protect the environment.Flickr An example of a Flickr like wiki theme developed with Theme BuilderFree Plugins Adaptavist regularly release projects as open source, licensed as BSD, ASL2 or MIT. We don't believe in, and will never ...JIRA hosting, Confluence hosting and other Atlassian hosting services - dedicated and shared solutions Starter, dedicated and remote hosting services for Confluence, JIRA and all other Atlassian products.Plugin Labs - Confluence and JIRA plugins, developments and ideas that extend Atlassian software Public Resources This space contains several resources (eg. images, logos) that are used throughout our site. It's easier to keep them in...Scriptix Plugin Scriptix is a Confluence plugin that enables you to quickly create powerful macros, actions, servlets and much more usin...Services Theme Builder Plugin Tutorials, forum, support and more for our Theme Builder plugin, which is used to customise Confluence.wikipedia An example of a Wikipedialike wiki theme developed using Theme Builder.
To display a specific tab from the spaces list, use the following notation:
{spaces:team}In the example shown above, the contents of the Team tab will be shown:
Team Spaces
Adaptavist - Atlassian consultants specialising in Confluence and JIRA plugins, training, hosting and support services Adaptavist are Atlassian Partner and global experts in consultancy, plugin development, training and support services fo...You can also specify:
- all (default)
- my (the user's favourite spaces)
- new (new spaces, if present)
Hints and Tips
If you place this macro on a popular page, it will place a high load on your server as not only does it need to search for spaces, it also has to check the current users' permissions for all of those spaces. We strongly reccommend that you don't place this macro on a home page – instead it should be on an alternate page that the user has to navigate to should they want to see the spaces list.
Comments (11)
Aug 13, 2007
Julia Debari says:
I am trying to create a custom dashboard and I only want to show the spaces the ...I am trying to create a custom dashboard and I only want to show the spaces the user has access to when they login.
Sounds simple enough, however, if a user belongs to more than one group, the spaces are listed multiple times. I am using the show-to macro using group permissions. I also tried the list-spaces macro, but had the same results.
Is there another way to do this?
Aug 13, 2007
Guy Fraser says:
If you use the spaces macro it should automatically filter the list to only thos...If you use the spaces macro it should automatically filter the list to only those spaces which the user can see...?
Can you paste your wiki notation in as a comment, wrapped in the noformat macro, eg:
{noformat} put your wiki notation here {noformat}Aug 13, 2007
Julia Debari says:
{show-to:group=confluence-administrators}{spaces:all}{show-to} {show-to:group=...{show-to:group=confluence-administrators}{spaces:all}{show-to} {show-to:group=confluence-users}{spaces:all}{show-to} {show-to:group=project-managers}{spaces:all}{show-to}I am a member of all three groups, so when I log in as an administrator I see three lists. if I log in as just a user I see only one list.
Thanks!
Aug 14, 2007
Guy Fraser says:
The confluence-users group includes 100% of all logged-in Confluence users, incl...The confluence-users group includes 100% of all logged-in Confluence users, including site admins (confluence-administrators) and project managers (project-managers) and any other group or logged in user.
As such, if you're showing to confluence-users there's no point in having any of the other groups listed because it's already shown to them:
{show-to:confluence-users}{spaces:all}{show-to}Aug 14, 2007
Julia Debari says:
Thanks, I knew it was something obvious.Thanks, I knew it was something obvious.
Aug 14, 2007
Julia Debari says:
So it also looks like all groups inherit the permissions of the confluence-users...So it also looks like all groups inherit the permissions of the confluence-users group. I need to modify each space to not have the confluence-users group and just the groups I want. Is this correct?
Thanks.
Aug 14, 2007
Guy Fraser says:
Yes - pretty much everything in Confluence is based around the permissions syste...Yes - pretty much everything in Confluence is based around the permissions system. So, if you set the space privileges to only allow specific groups and users (but not confluence-users) then not only will those spaces be hidden in the spaces macro (for people who aren't allowed to see them) but also in all other macros and searches, etc.
Sep 24, 2009
Ludwig Leuschner says:
Hi all, I have a nasty problem: When I open the link "Browse Space" with Firef...Hi all,
I have a nasty problem:
When I open the link "Browse Space" with Firefox, all went perfect.
But when I am logged in with IE and click on the "Browse Space"-Link, I came to the attachments for this space :-/
Can somebody tell me where I can manipulate this macro or something like this?
Feb 23, 2010
Jonas Lindström says:
Hi! We just took Theme Builder into global use today, with much applaud to the ...Hi!
We just took Theme Builder into global use today, with much applaud to the new layout. I must say it's a great tool for interface design.
I ran into a problem, though, as the favourite function of the spaces macro stopped working. Or rather I doubt it ever did work, as we used to use the built-in spacelist function that Atlassian provides.
When clicking on a star for a space, I get the following Javascript error: AJS.safe is undefined in favourites.js. The function fails as the favourite state of the space doesn't change.
In addition the tabs stop responding entirely, and I'm unable to switch tabs unless I reload the page.
Today I also noticed that the content in recently-updated-dashboard isn't filtered by tab as it should be.
Any idea why this is happening?
We're using Confluence 3.0.1 with Theme Builder 3.3.6-conf210.
Feb 25, 2010
Jonas Lindström says:
Incidentally, using Confluence 3.1.1 and Theme Builder 4.0.1, the favourite func...Incidentally, using Confluence 3.1.1 and Theme Builder 4.0.1, the favourite function works as intended. However, the content in recently-updated-dashboard still isn't filtered by tab... If I enable the default theme, it works just fine. If I enable the Builder theme, the filtering breaks.
Oct 15, 2010
heather says:
I am using the teams tab only. I want to delete the info explaining what teams a...I am using the teams tab only. I want to delete the info explaining what teams are. We are using it a bit differently, so is it not accurate and confusing. Can we delete the text so it just says teams and then gives you the drop down box?