Documentation for Confluence 5.4.
Documentation for Confluence OnDemand and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

A space category is a label that you can apply to a whole space for the purpose of categorising your spaces in the the space directory, and in the recent activity area of the dashboard

You need to be a space administrator to add space categories.

Using space categories

Here is an example of using space categories. Let's assume that you have one or more spaces that your Sales team may be interested in. You can use the category 'sales' to group those spaces together.

  1. First add the 'sales' category to the relevant spaces, as described below.
  2. Then, in the space directory, you can click the relevant tab to see only the spaces with the chosen label. See Viewing All Confluence Spaces.
  3. And, you can see updated content in those spaces by choosing the 'sales' category under the Space Categories tab in the recent activity area of the dashboard. See Customising your Personal Dashboard.

On this page:

Related pages:

Categorising a space

When you categorise a space, you add a 'space category' to the space.  A category does not exist if there are no spaces labelled with that category.

To add a space category to a space:

  1. Go to the space and choose Space tools > Overview on the sidebar.
  2. Choose Space Categories: Edit.
  3. Under 'Space Categories', enter your category name and choose Add.
    Alternatively, choose a category in the list of 'Suggested Space Categories'
  4. Choose Done.

If your space is using the Documentation theme:

  1. Choose Browse > Space Admin at the top of the screen.
    Note: The 'Space Admin' option appears only if you are a space administrator for the space or you are a super user (a member of the confluence-administrators group).
  2. Choose Space Labels in the space administration options.
  3. Under 'Space Categories', enter your category name and choose Add.
    Alternatively, choose a category in the list of 'Suggested Space Categories'.
  4. Choose Done.

Removing a space from a category

Removing a space from a category is the same as removing the category from the space.

To remove a space category from a space:

  1. Go to the space and choose Space tools > Overview on the sidebar.
  2. Choose Space Categories: Edit.
  3. Choose the x next to the space category.

If you are using the Documentation theme:

  1. Go to the space and choose Space tools on the sidebar.
    Note: The options available in 'Space tools' differ depending on your space permissions. All space tools options are available if you are a space administrator for the space or you are a super user (a member of the confluence-administrators group).
  2. Choose Space Labels in the space administration options.
  3. Choose the x next to the space category.

Removing an entire space category

To remove a whole space category from Confluence, just remove that category from all spaces, as described above. A category cannot exist if there are no spaces labelled with that category. The space category will disappear from the dashboard and space directory.

To remove an entire space category from Confluence:

  1. Choose Spaces > Space directory on the header.
  2. Choose the space category that you want to remove.
  3. You will see a list of all spaces in that category. Choose the spaces one by one, and remove the category from each space, as described above.

Screenshot: Space categories

Notes

The ability to add space labels has been removed in Confluence 5.0 in order to simplify the way labels are used in spaces. Existing space labels will be preserved, but you will be unable to add new space labels. Space categories are unaffected by this change.

16 Comments

  1. This new category system for Confluence 3.5 looks awesome. However, I'd like to point out one potential improvement.

    It would be useful if a user could mark certain categories as favorite, giving those categories their own tabs in the space list and recently-updated list.

    This would make it faster to browse updates within certain favorite categories. As the feature is currently implemented, you have to first choose the category tab and then choose the category from a (potentially long) drop-down list.

    The end result would then be that for the space list, you could have the following tab layout:

    • All
    • Favourite
    • [Favorite Category A]
    • [Favorite Category B]
    • Categories (other)

    And for the recently-updated list:

    • All
    • Favourite Spaces
    • [Favorite Category A]
    • [Favorite Category B]
    • Categories (other)
  2. Hi 

    I was wondering if I can somehow display the spaces in a category other than alphabetically. Is there a way to change this setting?

    Thanks

    1. I would like this capability too.  Please vote for CONF-23587!

      1. Voted! This would be tremendously useful.

  3. Would be great to know the roadmap/timeline for working with categories via the Remote API.

  4. If I use a label as a space category is there any reason why I wouldn't also make it a space label? I can see why you wouldn't want to go the other way (copy all your space labels into space categories also), but what difference would it make to have category as a space label also?

  5. Anonymous

    I wish, confluence had a powerful label concept like mediawiki, which underlies every label with its own page. This allows to have persons responsible for a category including watch and notify functionality.

  6. Interesting concept of a watch page for labels. I wrote a plugin once that "listened" for label changes for pages and alerted me whenever "for_tcolson" label was used. I'm fairly certain a plugin similar to that could be created to give the label-page you describe, and more.

    See https://developer.atlassian.com/display/CONFDEV/Event+Listener+Module and com/atlassian/confluence/event/events/ConfluenceEvent

  7. Can one use escape characters so that labels with spaces are not broken into two separate lables? 

    1. Right, I found no way to escape a space category lable, e.g. we need something like "IT Departement" which is translated to "It Departement". Labels should be case sensitive for display.

    2. I was able to do this with a non-breaking space, Alt+255

  8. Anonymous

    Removing Space Labels makes it impossible to use the contentByLabel macro to create lists of Spaces by category.  None of the other macros allow one to create a simple list either.  the Spaces List presents the tabbed interface and there's no way to force the category drop down to a specific category.

  9. Anonymous

    I'd like to second the comment made by Anonymous (not me). By taking away space labels (and thereby neutering the contentByLabel macro), we no longer have a function to display a simple list of spaces (that is, a list of spaces that doesn't have tabs and doesn't require clicking anything). To replace the functionality you removed, you should change the contentByLabel macro so it can repot on categories, i.e., make it a contentByCategory macro. Thanks.

  10. I cannot believe you changed this functionality from working to not existant. As the to commenters right before me already mentioned, space-categories (or whatever you like to name them) should be accessible via macro.

  11. Space categories would be especially useful if accessible from the blog-posts macro. As it stands I have to maintain every news list manually. If I could list blog posts by space category, simply adding a space into that category would update the associated news feeds. Highly useful.

    The same applies to the recently-updated macro!