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

When you add a new page, you do not have to write the content from scratch. Instead, you can base your new page on a template. A template is a Confluence page with predefined content. Some templates are provided by blueprints or add-ons, others are defined by Confluence users.

Some examples of where templates are useful:

  • A software development project may have a template for use cases.
  • A systems administration space may have a template for defining what information is kept about each server.

Global templates and space templates

In Confluence, there are two places to store your page templates:

  • Space templates: These page templates are available in a specific space only. People who have space administrator permission can define templates via the space administration screen.
  • Global templates: These page templates are available in every space on the site. People who have Confluence Administrator permission can define the global templates via the Confluence Administration Console.

System administrators can also download predefined templates.

On this page:

Related pages:

Creating a template

You can write your template using the Confluence editor. You can also add special variables to the page, if you want to include fields that the author will complete when adding the page. See Adding a Template for more information.


Using a template

Page templates are used only when adding a page. It is not possible to apply a template to an already-existing page. Once a page has been added using a template, the template is no longer linked to the page. All further editing is performed as if the template was never used. Some plugins provide enhanced template functionality. You can search the Atlassian Marketplace for template add-ons.

See Creating a Page using a Template for more information.

Templates provided by blueprints

A blueprint is a page template with added functionality to help you create, manage and organise content in Confluence.

Confluence ships with some predefined blueprints.

 You can also download additional blueprints from the Atlassian Marketplace. You can customise the blueprint templates to suit your individual needs, disable particular blueprints or even develop your own blueprints.

See Working with Blueprints.

Promoting templates in the Create dialog

Space administrators can choose to promote specific templates and blueprints in the Create dialog. Promoting items can help ensure consistency in a space by encouraging users to create particular types of content over blank pages. 

The promoted templates or blueprints will appear at the top, with all other content types, including Blank Page and Blog Post collapsed under them. To view the other types of content available choose the Show more link. 

To promote a template or blueprint:

  1. Go to Space Tools > Content Tools.
    If your space is using the Documentation theme choose Browse > Space Admin > Templates.  
  2. Choose Promote next to the templates or blueprints you want to appear in the Create dialog.

Remember: by promoting a blueprint or template you will be hiding all other items, including blank page and blog post, under the Show more link. 

System templates

Confluence also provides 'system templates' containing content like the site welcome message and default space content. See Administering Site Templates.


  1. Anonymous

    Is there a macro that can retrieve a template's definition?  In other words, if I create a template for reporting a software issue with fields for name, description, steps to reproduce, severity, etc, can I display the fields of this template in a documentation page by using a macro that references the template definition rather than duplicating the list of fields by hand?  Thanks!

  2. Is it possible to have something like a "persistent template"? I refer to the following hypothetical situation:

    As soon as you use a template, the created page ist connected to this template (of course, templates can be connected to multiple pages then). If you change the layout of the template, all other sites, created by using this template, are also being changed automatically so that their layout matches exactly the template's one (all the time).

    Does anyone know maybe some plugin or technique? Because I know, that this is not the way, Confluence templates work...

    Thanks in advance!

  3. Anonymous

    I also would like to have a template that stays attached to a page so that when there is a change on the template, it can change all pages created with that template in the past.   Anyone know of a way to make this work?


    Also, I have some tables with text linked to other pages within my space and to other websites using their urls.  When i use Ceate a Page from the Template, the tables don't come through and  all of the links disappear on the newly opened page.  Does anyone know why this is happening??  .

    1. Hi MLasaj and anonymous, Confluence's page templates are applied at the point a page is created. Changes to a template do not affect pages that have previously been created with that template. So you are correct that Confluence does not support the kind of dynamic or persistent templates you are describing out of the box. 

      You might want to ask this question over at Answers, as someone in the community may have ideas that will help, or plugin suggestions. 

  4. Does confluence support the ability to create a template for creating spaces. So if we get a new client. I can create a space for them with the 10 pages that we need for every client?



    1. Hi Nick,  there is no way to create space templates in Confluence. One workaround is to use the Copy Space add-on from the marketplace. You could create a 'template' space and copy it each time you need to make a space for a new client.   There is some information on this here Creating your Technical Documentation Space.  Please note that the Copy Space add-on is not supported, and is not available for Confluence OnDemand. 

      If you have developer skills or access to developer resources you could look at creating a Space Blueprint. You can find out more here: Developer Tutorial: Space Blueprints

      Hope this helps, Rachel. 

  5. Is it possible to promote the "Blank Page" template like the same way I can do it with my custom template? I would like to see my custom template and the "Blank Page" template as well in the selection mask.

    1. Similarly, I would also like to promote some "Global" templates we created in-house.  I did not see any "Promote" button beside the Global templates.

      1. Hi Markus and Sylvain, I'm happy to hear you are finding the promote feature useful. I've passed your comments about promoting both blank pages and global templates to the product manager who looks after this feature. 

  6. I created a space template, but I would like it to be a global template. Is there a way to turn a space template into a global template ?

  7. Is it possible to put a link in a template to an anchor within the sameTemplate? I want to have a link at the bottom of every page that takes the user back to the top using an anchor at the top. I've created a link like this in many pages, and I can create the anchor at the top of the template with no problem, but when I try to add the link at the bottom, the UI complains that my anchor syntax (#anchorname) is incorrect. Are links to anchors within a template not possible?

    1. Hi Melissa, This issue has been raised as a bug - CONF-5763 - but has since been closed.

      A workaround for what you are trying to do is to insert an HTML macro into your template with html code as follows:

      <a href="#main">Back to Top</a>
      1. Thanks for the reply, Adrian. When I created a link using that HTML, it worked! Thanks.

        1. Sorry, I spoke too soon. The suggested HTML works fine within a page that was created using the template I made, but it does NOT work if I try to add it within the Template itself.I get a warning that "The markup provided is not valid link markup."

          Again I ask: Are links to anchors within a template not possible?

          1. Hi Melissa, just checking you inserted the code into an HTML macro on your template? I've double checked and it works fine for me. Also it's worth noting HTML macros may have been disabled by your administrator, so this option might not be available to you.

            As mentioned, this is a workaround, and linking to anchors within a template has been raised as a bug.

            1. OK, I just realized you are talking about using a different kind of macro. I was just using the Link option then the Advanced option. When I look for an HTML macro in the macro browser, a few different ones come up, can you be more specific as to the type I should use?


              1. Hi Melissa, help for the HTML macro can be found on this page: HTML Macro. It should also come up if you type HTML in the macro browser.