Customizing Default Space Content

Still need help?

The Atlassian Community is here for you.

Ask the community

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. Error rendering macro 'excerpt-include'

    User 'null' does not have permission to view the page.

  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 customize 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. Error rendering macro 'excerpt-include'

    User 'null' does not have permission to view the page.

  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. 

Last modified on Jun 6, 2016

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.