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

Confluence Administrators can edit the template that is used to create the home page for new sites. This default content appears on the home page when a new space is created. There is a different template for site spaces, personal spaces and space blueprints.

The default content in the template only appears for new spaces (those that are created after you have defined the content). Changes to the template do not affect existing home pages.

Edit the default home page for a blank space

To edit the default (blank) space content template:

  1. Choose the cog icon  at top right of the screen, then choose Confluence Admin.

  2. Choose Global Templates in the left-hand panel.
  3. Choose Edit next to 'Default Space Content' or 'Default Personal Space Content' depending on whether you want to customise the content for new site space or personal space home pages.
  4. Enter the content that you want to appear on the home page for new blank spaces. you can add variables, macros and other content in the saw way as edited a page template.
  5. Choose Save.

On this page:

Related pages:

The following variables are available to be added to the default space content templates.

  • $spaceKey - inserts the space key into the site space homepage 
  • $spaceName - inserts the space name into the site space homepage
  • $userFullName - inserts the user (owner of the personal space) into the personal space homepage
  • $userEmail - inserts the email address of the user (owner of the personal space) into the personal space homepage.

Default space templates differ from ordinary page templates in that they do not present the user with a form to complete, so variables should be limited to those listed in the Variables menu.

Some macros, such as the Table of Contents macro, may not display correctly when you preview the template as they are designed to work on a page. The macros will display correctly on the home page when you create a new space. For more information on editing a template, including adding macros see -  Adding Content to a Template.

Reset the original default content

To reset the original default content:

  1. Choose the cog icon  at top right of the screen, then choose Confluence Admin.

  2. Choose Global Template in the left-hand panel.
  3. Choose Reset to default next to the template you wish to reset.

From this point on, all new space home pages will be created with the original default content. 

Screenshot: Global Templates showing the 'Default Space Content' or 'Default Personal Space Content' system templates. 


36 Comments

  1. Anonymous

    How do I set default content for other pages?

    1. Hi there,

      As far as I am concerned, you can try adding a custom layout for normal Confluence pages. Browse to Administration Console and click Layouts under Look and Feel. Click Create custom next to Page Layout and look for this line of codes:

      <div class="wiki-content">
                 $body
              </div>
      

      Edit your content in between this line of codes where the $body has been define. Save the changes and try creating new page. Please note that this will affect all of the pages in the space.

      Refer here for more details on Customising Layouts

      Cheers,
      Komathi

  2. Anonymous

    Why does a separate panel with my profile and recent updates appear to the right of all my pages in my personal space.

    1. Hi,

      This feature was introduced in Confluence 3.0. Here's the link to release notes that explains about this feature:

      In case, you would like to disable it, please refer to this comment. You might need to remove the line:

      altogether if you do not want it.

      Hope this helps.

      Cheers
      JSashi

  3. Is it possible to Change the name of the Default Space Home Page.

    I want all new home pages to be named "Welcome" instead of "Home".

    1. Hello Dhyana, I am afraid that this is already set in the code base (com.atlassian.confluence.spaces.DefaultSpaceManager). If you would like to request for this feature, feel free to raise one at http://jira.atlassian.com/browse/CONF

      1. Thanks very much for the reply.

        What about customising the content of the default Home page?

  4. Anonymous

    I want to modify the space content by adding a taskdock macro to list all the tasks for that space. It requires the space key for that space. Can i get it as confluence replaces {0} with the space name ... i tried using {1} but it was foolish :P

    1. Anonymous

      +1 for this feature

      1. Anonymous

  5. Anonymous

    It would be nice to allow to specify the name of the default "Personal Space Home Page" - because each one being named as "Home" makes it look unintuitive on the Recently Updated feed on the dashboard.

  6. Is it possible to change the default space permissions?

    We want the Anonymous checkbox checked as default. is that possible?

    Choose who can view and comment on content:

     
     
     

     

    Best regards,

    Alex

  7. Is it possible to change the default space permissions?

    We want the Anonymous checkbox checked as default. is that possible?

    Choose who can view and comment on content:

     
     
     

     

    Best regards,

    Alex

  8. Anonymous

    Customizing Default Space Content appears to require knowledge of the macros.  Unfortunately with 4.0 it looks like all the macros are handled WYSIWYG through the insert macros functions, which this page lacks.

     

    Going to the Confluence help, it looks like the macros have replaced with instructions on how to insert the wysiwyg components.

     

    I can add a list of attachments to a page, and it works great.  I'd like to add attachments list as default content, under the documents tree, for all pages.  I can't find the syntax for that though.  I'll start guessing, but some help would be appreciated.  Even better would be documentation on the raw syntax someplace.

  9. The wiki markup syntax for all macros is still available in the Confluence 3.5 Documentation. For example, the Popular Labels Macro is documented here.

     

  10. Anonymous

    Should new pages of a space preferably be child pages of another page, such as the home page?

    I have been creating all pages in the root of my space without a parent page, but find that the Page Tree and Page Tree Search macros need a root page to display the content.

     

  11. I need access to the personal space owner's username, can we have a 

    {3} - username

    Thanks.

    1. Anonymous

      yes this would be awesome and super handy

  12. This page is out of date.

    For Confluence 5.0, you need to look in Global Templates to update default home page content.

    1. Thanks Bob, you're right. We actually have a draft page ready to publish for Confluence 5.0, which does correctly describe the global templates option. Up to now, we've only published a subset of C5.0 doc updates, being those which are already deployed to Confluence OnDemand. Alas, it means that this space is a bit of a mishmash between C4.3 and C5.0 at the moment. (smile)

      That said, it's really great to receive comments about things we've got wrong, in case we've missed them altogether. Thanks! (star)

  13. Is there any way to limit the content a user can view in their Dashboard so that they only see content/activity in the Space(s) they have permissions to view? We want to create customer-accessible Spaces, but when they login they are automatically sent to the Dashboard, which displays content/activity that they have not been granted access to view.

    Do we need to stand up a separate instance in order to hide this content?

    1. Melissa Lanning, the Dashboard should not show any content that a user does not have permission to view.

      If this is not the case on your instance, you should raise a support ticket to find out what is going on, as it is definitely unexpected behaviour.

      Cheers,
      Mark

  14. I found this solution, but since it's global and cannot be applied per-user or per-group, it won't fit our use case.

    Configuring the Site Home Page

     

  15. Thanks for the speedy reply, Mark.  I tested this and you are correct, once I set up the user's group permissions correctly and adjusted the Space permissions, the user only sees the content in their Dashboard that they have been granted access to see.

    Melissa

  16. I wanted to know if there is a way to create a global space template so when one creates a new space all the infomration that is needed would be displayed for the user. I am working on some documentation and I would like to be able to create a space with all the pages needed within that space.

    1. Hi Oleika, we have a feature request for this  CONF-4538 - Creating a Space Template Open . Curious to hear what type of space is this for? We're looking at making some improvements in this area. What kind of page structure would you create for your space? 

  17. I cannot find any "advanced editing documentation". I would like to insert the Variable $spaceKey into a hyperlink to automatically setup a basic feed for a space. How can I do this since the editor interprets this as a usual string. Secondly I'd like to hand over a variable to the title parameter of the tipp makro.

    Can you help me?

  18. Default space templates differ from ordinary page templates in that they do not present the user with a form to complete, so variables should be limited to those listed in the Variables menu.

     

    Where is that Variables menu? I really want to add some variables for initializing a new project (e.g. project URL) that would be prompted when creating a new space. Is that possible?

    1. Hi Dmitry,  Sorry, the variables are listed in the Templates menu, under Add Variable.

      Currently it is not possible to prompt for users to fill in information when creating a space (as happens when you use a page template). You could provide a note on the homepage prompting users to edit the page and add the Project URL - not perfect, but might help. 

      1. That's very unfortunate.

        I created a feature request for that:  CONF-30871 - Support custom variables in the Default Space Content (homepage) template New

        And also linked it to a bigger feature request that I also support:  CONF-4538 - Creating a Space Template Open

  19. Is there any way to change specific space templates (i.e. default template for Team Space, default template for Documentation Space, default template for Knowledge Base Space)? Thanks.

    1. Hi Radek, 

      Sorry there is not currently a way to edit the default templates for Space Blueprints.  Are you wanting to be able to edit the homepage template, the sidebar configuration? 

      1. Thanks for reply. I'm more interested in editing of the default space homepage. I like the blueprints but I'd like to have them a bit customized.

        1. Radek Janata (AVG) you can customize the default space homepage for ALL spaces by editing the following Default Space Content global blueprint:

          Confluence Admin -> Global Templates and Blueprints -> Default Space Content

          You can't, however, set up individual templates for each space or configure "default" pages that would be automatically created together with a homepage. Please see the relevant tickets and upvote if you need that too:

          • CONF-30871 - Support custom variables in the Default Space Content (homepage) template New
          • CONF-4538 - Creating a Space Template Open
          1. Hi Dmitry, that's correct, you can customise the default space content for blank spaces and personal spaces.  But there is not currently an option to customise the default space content for space blueprints such as Team Space or Knowledge Base. 

            I've created an issue to track this feature request.  Feel free to comment or watch  CONF-32902 - Customise default space homepage content for space blueprints New