Customising Default Space Content

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 , then choose General Configuration under Confluence Administration

  2. Choose Global Templates and Blueprints 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.

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 , then choose General Configuration under Confluence Administration

  2. Choose Global Templates and Blueprints  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. 

Was this helpful?

Thanks for your feedback!

39 Archived comments

  1. User avatar

    Anonymous

    How do I set default content for other pages?

    11 Feb 2009
    1. User avatar

      Komathi Krishnan [Atlassian]

      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

      16 Feb 2009
  2. User avatar

    Anonymous

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

    24 Jun 2010
    1. User avatar

      Sashidaran Jayaraman [Atlassian]

      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

      17 Aug 2010
  3. User avatar

    Dhyana Scarano

    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".

    09 Aug 2010
    1. User avatar

      Azwandi Aris [Atlassian]

      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

      10 Aug 2010
      1. User avatar

        Dhyana Scarano

        Thanks very much for the reply.

        What about customising the content of the default Home page?

        19 Aug 2010
        1. User avatar

          Azwandi Aris [Atlassian]

          No worries. Check out Customising Default Space Content to do so, which is this page (smile)

          19 Aug 2010
  4. User avatar

    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

    22 Feb 2011
    1. User avatar

      Anonymous

      +1 for this feature

      25 Aug 2011
      1. User avatar

        Anonymous

        +2

        15 Feb 2012
  5. User avatar

    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.

    26 Mar 2011
  6. User avatar

    Alex Ghezelbash

    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

    19 Sep 2011
  7. User avatar

    Alex Ghezelbash

    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

    19 Sep 2011
    1. User avatar

      Michelle Vincent

      Yes, we would like this ability as well. The default is for all users to be able to blog from each other's personal space. That doesn't make sense at all. That means, that when clicking on create, the first personal space name in the alphabet automatically often appears as the location which the user often doesn't notice.

      27 Feb 2015
      1. User avatar

        Giles Brunning [Atlassian Technical Writer]

        Hi Michelle,

        While you can control the default space permissions, users can, as you say, create blog posts in each other's personal spaces.

        I can't see a good way around this, so feel free to propose a suggestion on changing this functionality.

        01 Mar 2015
        1. User avatar

          Michelle Vincent

          Thank you. I have added a ticket for this.

          02 Mar 2015
  8. User avatar

    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.

    15 Oct 2011
  9. User avatar

    Mark Hrynczak [Atlassian]

    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.

     

    16 Oct 2011
  10. User avatar

    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.

     

    30 Jan 2012
  11. User avatar

    Royce Wong

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

    {3} - username

    Thanks.

    09 Feb 2012
    1. User avatar

      Anonymous

      yes this would be awesome and super handy

      27 Nov 2012
  12. User avatar

    Bob Swift [Bob Swift Atlassian Add-ons]

    This page is out of date.

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

    08 Feb 2013
    1. User avatar

      Sarah Maddox [Atlassian]

      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)

      10 Feb 2013
  13. User avatar

    Melissa Lanning

    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?

    01 May 2013
    1. User avatar

      Mark Hrynczak [Atlassian]

      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

      02 May 2013
  14. User avatar

    Melissa Lanning

    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

     

    01 May 2013
  15. User avatar

    Melissa Lanning

    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

    02 May 2013
  16. User avatar

    oleika redd

    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.

    09 May 2013
    1. User avatar

      Sherif Mansour [Atlassian]

      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? 

      13 May 2013
  17. User avatar

    Andre Pliewischkies

    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?

    16 Aug 2013
  18. User avatar

    Dmitry Pashkevich

    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?

    18 Sep 2013
    1. User avatar

      Rachel Robins [Atlassian Tech Writer]

      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. 

      19 Sep 2013
      1. User avatar

        Dmitry Pashkevich

        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

        20 Sep 2013
  19. User avatar

    Radek Janata (AVG)

    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.

    06 Mar 2014
    1. User avatar

      Rachel Robins [Atlassian Tech Writer]

      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? 

      09 Mar 2014
      1. User avatar

        Radek Janata (AVG)

        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.

        10 Mar 2014
        1. User avatar

          Dmitry Pashkevich

          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
          10 Mar 2014
          1. User avatar

            Rachel Robins [Atlassian Tech Writer]

            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

            11 Mar 2014
Powered by Confluence and Scroll Viewport