Create a Space

When you create spaces in Confluence, you can choose to set up a space for each team, project, or a mix of both depending on your needs. You can always move pages and blog posts between spaces later if you need to.

Confluence allows you to set up a blank space, or use the handy space blueprints to make the process of setting up team, documentation, or knowledge base spaces quick and easy.

Create a space

  1. Choose Spaces > Create space in the Confluence header
  2. Select the type of space you would like to create, then choose Next
  3. Enter details of your space including Name and Space Key , and any other information you're prompted for depending on the blueprint you choose
  4. Choose Create

Each space you create will automatically have a home page, which you can customise to display relevant information for people viewing the space. Space blueprints have a home page with extra features like team members in the case of the 'team space' blueprint.

/download/attachments/139463/createteamspace-new.png?version=1&modificationDate=1426480915402&api=v2" width="60"/>

You can also set up a personal space to store your own work, which you can share with others or make private. Choose your profile picture at top right of the screen, then choose Add Personal Space.... See Create a Personal Space for more information.

Space keys

Each Confluence space has a space key, which is a short, unique identifier for a space, and forms part of the URL for that space. Each time you create a space, Confluence will create the space key for you, but you can override the default space key if you want to make it something more memorable.

For example, you might give your marketing team's space a key of 'marketing'. You can then navigate directly to the space using a URL like this:

Choosing a space key

Each space key:

  • Must be unique
  • Can contain any alphanumeric character (A-Z, a-z, 0-9)
  • Can be up to 255 characters long

You can't change the space key after you create your space, so choose your space key carefully! Personal spaces use your username as the space key.

Space blueprints

A space created using a space blueprint will have a customised homepage, sidebar and may contain page blueprints or sample content that's 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.

The types of space blueprints available are:

  • Team space – A great building block if you are using Confluence as an intranet or to manage teams. Team spaces highlight the members of the team, and grant permissions to those users accordingly. 
  • Knowledge Base space – This space blueprint uses search and page labels to make content easier to find, right from the space homepage. It also contains two page blueprints for creating how-to and troubleshooting articles. The templates used in these page blueprints are completely customisable to meet your needs. The Knowledge Base space blueprint also integrates with JIRA Service Desk.
  • Documentation space – This space blueprint displays the full page tree in the sidebar and hides other sidebar features including blogs and shared links. The homepage uses search and page labels to make content easy to find. Add the 'featured' label to any page you want to highlight on the homepage. This space does not include any page blueprints but you can create and promote templates for your documentation authors to use.

Space permissions

Each space is created with a set of default permissions. The user who created a site space is automatically granted 'space admin' permissions for that space, meaning they can then grant permissions to other users and groups. See Space Permissions Overview for more information.

(info) To create a site space you need the 'Create Space' global permission; to create a personal space you need the 'Personal Space' global permission.

Note: System Administrators can edit the permissions of spaces in their Confluence site at any time.


  • If you've set a specific theme (such as the Documentation or other third party theme) for your whole site, spaces will be created with that theme. You may not see some space blueprint-specific sidebar customisation if you're not using the default theme.
  • Administrators can disable individual space blueprints - see Administering Site Templates.
  • Spaces can't be nested (you can't have a space within a space), but can be grouped using space categories.
  • You can export a whole space, or part of a space, to  PDF, HTML or XML .

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

18 Archived comments

  1. User avatar


    When trying to create a new space, this message appears:

    Page Not Found

    The page you were trying to reach could not be found. This could be because:

    • The page does not exist.
    • The page exists, but you do not have permission to view it.
    09 Jul 2013
  2. User avatar


    Same problem here. 

    10 Jul 2013
  3. User avatar


    Also, the same problem. Can't cr8 new spaces at all.

    11 Jul 2013
  4. User avatar

    Robert Congdon

    I as well have this problem, what do?

    12 Jul 2013
  5. User avatar

    David Bertolini

    Same problem!

    14 Jul 2013
  6. User avatar

    Steven Thomas

    I had the same problem and found this workaround:

    Basically  you turn off 'Default Space Logo' and then retry creating the space.

    17 Jul 2013
  7. User avatar


    Yes, same problem here.

    23 Jul 2013
  8. User avatar


    Same problem!

    25 Jul 2013
  9. User avatar


    Can space names have special characters in them? If not, where is the documentation for what is allowed for/in a space name?

    04 Sep 2013
  10. User avatar



    Can you change the privacy setting for a SPACE or page? You can select to make a space private when you initially start to create it, but is there no way to change this privacy setting afterwards??

    10 Sep 2013
    1. User avatar

      Alex Conde [Atlassian]

      Hi Dee.

      You can indeed change the privacy settings once the space is created as explained in Space Permissions Overview.

      You can also change the privacy for a single page as explained in Page Restrictions.

      Please note this is not the right place to ask questions, as comments are not actively monitored. Next time you have a similar question, I suggest you to add it in Atlassian Answers instead.

      11 Sep 2013
      1. User avatar


        Thank you Alex, and I will certainly add questions on the page you sent me in the future. I still don't see a way to make a space public after you have created it as a private space. The only recourse is to follow the steps to give permissions to groups or individuals. There is no link, no checkbox to make it public (like there was to make it private).

        11 Sep 2013
        1. User avatar

          Alex Conde [Atlassian]

          Changing the permissions is the way to do it. That's what the tick on the creation process does automatically.

          12 Sep 2013
  11. User avatar

    Carlos Eduardo

    Can´t create spaces.

    Eternal "loading"... even in a fresh installation


    25 Mar 2014
  12. User avatar

    Ernest McGray, Jr.

    Seems to not be working appropriately.  I created one space but it just freezes when trying to create other spaces.  I've used the back key, refreshed, etc. and it just doesn't create the new space I request. 

    25 Mar 2014
    1. User avatar

      Rachel Robins [Atlassian Tech Writer]

      Hi Ernest and Carlos, looks like there is an issue creating new spaces in OnDemand.  I've added some more detail to Ernest's issue here  CONF-33055 - Create new space dialog freezes in Confluence On Demand Resolved .  Watch the ticket for further updates. 

      25 Mar 2014
  13. User avatar

    loretta rinaldi

    Is there a way to force some spaces to appear towards the bottom without numbering every single space?  Some special character, perhaps, that would cause 4 of my 11 spaces to show up at the bottom of the list?

    25 Apr 2014
    1. User avatar

      Rachel Robins [Atlassian Tech Writer]

      Hi Loretta, do you mean in the space directory or on the dashboard? There is no way to force the order of these spaces. 

      On the dashboard you can mark some spaces as favourite, so they appear in the favourites list which helps for getting to commonly used spaces (but I think this only shows up once you have more than 20 pages).  In the space directory you can apply categories to filter the list, and filter out spaces you don't wish to see. 


      28 Apr 2014
Powered by Confluence and Scroll Viewport