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

In Confluence, content is organised into spaces. There are two main types of space:

  • Site spaces, sometimes called 'global' spaces, are areas on your site where you can create content and collaborate with other users. For example, you might create a space for each team or project in your organisation. 
  • Personal spaces belong to specific users. You can keep your personal space private, or open it up for other users to view or edit. Personal spaces are listed in the People Directory

What is a Space?

A space is an area within Confluence, containing your pages, blog posts and other content. You can think of each space as a sub-site, or mini-site, each with its own home page.

You can create a blank space or choose to use a space blueprint.

Each space:

There is no limit to the number of site spaces you can create in Confluence.

What is a Space Blueprint?

Space Blueprints allow you to create common types of spaces, such as a team space or knowledge base, quickly and easily.

A space created using a space blueprint will have a customised homepage, sidebar and may contain page blueprints or sample content that is specific to that type of space.

When you create a space using a blueprint a wizard will prompt you to enter information to help set up your space. For example the Team Space blueprint asks for the members of your team, and displays them on the homepage.  

Viewing the spaces in a Confluence site

Confluence displays a list of spaces in the following locations:

Example: Favourite spaces as shown on the dashboard

The screenshot below shows the area of the Confluence dashboard that displays the spaces that you have marked as favourite:


A space key is a short, unique identifier for a space. For example, you might give your documentation space a key of "DOC". To find the key of an existing space, look at the Confluence URL for a page in the space. The standard Confluence URL has this format:

  • No labels


  1. Note that for personal spaces, the spacekey is ~username , where username is the login used.

    This should be mentionned.

  2. Anonymous

    How can I add links or pages to the space shortcuts?

    1. Hallo there

      This page describes how to add shortcut links: Configuring a Sidebar. I've added a link on the above page too, so that other people can find it more easily.

      Cheers, Sarah

  3. Anonymous

    Hello Sarah (smile)

    How do we organize the Spaces in hierarchy form? For example: we have a space named A ~ J. We wanted Space B on top of Space A due to priority. We have tried using numbered Spaces but when it reaches number 10, the lineup will be

    1. B

    10. J

    2. A

    3. C

    Thanks in advance!

    1. Anonymous

      By the way, this is in the Dashboard

    2. Would also like to order spaces by our priority

      1. Hi Anton,


        I have the same request than the user above.

        Do you have a solution?


        Thank you



  4. Anonymous

    Hello, guys!

    Could you please help me - is any way to create new space under another one like child space?

    1. Parent space
      1.1 Child space

    I've seen such example on one confluence but I haven't found the solution.


    Thank You in advance,


  5. Hi Mariya,  from the above doc:

    Useful notes about spaces and pages:

    • Spaces cannot be nested. You cannot have parent and child spaces, but you can have parent and child pages within a space.


    Shawn Sanders

    Turner Broadcasting

  6. Anonymous

    German bitter liqueur Jagermeister, German means " hunter ." It consists of a variety of herbs and spices fused together , deeply loved the  air force 1 low uk air force 1 mid uk people in Europe , the recent well-known sports brand Nike's skateboarding Nike SB branch in this wine is made ??like , designed a SB Dunk Hi, terms of color reference Jagermeister packaging colors, red, green and black tricolor selected as the main color , very eye-catching , it should be for the long-silent Nike SB branch broke out some new vitality.

  7. How do I edit a space's team members after it's been created?

    1. Exactly my question... seems impossible!

  8. Anonymous

    Me too. Me too.

    1. You need to add a column to the right end of your profile picture boxes.

      Insert profile picture macro on the top, and mailto: shortcut below.

  9. Is there a simpler way to add team members to an existing team space? Ersat's suggestion seems like a workaround. When I added a team member as a macro, it does not look the same as the other team members. It seems like there should be a simpler way to do this.

  10. Anonymous

    Appearantly there is no macro for this that automatically shows changes to the team. It's a static text + photo you have to put in there. But if your team space page is one of the main pages, a lot will happen on that page, so it will be subject to change anyway.

  11. Anonymous

    Seems something of an oversight to not be able to edit the team members easily after creation!

  12. We are evaluating Confluence and I am disappointed that the "Team Member" portion of the Team Spaces blueprint is apparently just window dressing.

    And, even as window dressing it is difficult to update.

    It should be a functional thing, displaying the actual members of the team as per the permissions.

    And, if that functionality cannot be added, at the very least it should be very easy to update with team members.

  13. Is there any limit for number of spaces , number of pages , number of blogs in confluence .

    Is there any kind of limit for confluence .

    1. Hi Abyakta, sorry for the late reply. I am not aware of a specific upper limit. This Confluence site (housing our documentation) has over 400 spaces, and some spaces, like this one, have up to 2 thousand pages. 

      If you have specific concerns about the size of your proposed instance, I would recommend contacting Support, or perhaps talking to an Atlassian Expert for assistance. 

  14. When dealing with personal spaces Ref.

    spacekey is ~username

    How does this syntax change with usernames which contain a space?


    I am trying to use the page index plugin to return shared links from my personal space, my username is "Brett Evans"

    I have tried "~Brett Evans" and "~Brett+Evans" but neither are working.

    1. did you try ~brett.evens ?

    2. Hi Brett, 

      Space keys cannot contain spaces or special characters, so I would assume a personal space key, where a username contained spaces would be ~brettevans. (I'm also assuming your Confluence instance is managing users externally, as Confluence's internal user management does not allow usernames with spaces).

      To confirm the space key for your personal space, you could navigate to a page in your personal space, and check the space key that appears in the URL  (e.g. .../display/~rrobins/page+title). 

      Just checking also, you are using the Page Index macro? That macro has no parameters, so can only be placed within the space it is reporting on - so you should be able to just place it on any page within your personal space.

      Hope this helps, if you continue to have issues, feel free to contact Support.