Documentation for Confluence 5.8 (Server).
Documentation for Confluence Cloud 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 categories of page templates:

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

System administrators can also download predefined templates.

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 Creating 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

If you're a space administrator, you 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, instead of 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'll be hiding all other items, including blank page and blog post, under the Show more link. 

If you use the Show more link in the create dialog more than three times in a single space, the dialog will show you all templates by default from then on. 

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 ?

    1. Sorry there is no way to do this. 

  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.

  8. Hi, I was wondering if someone could help. 

    I have recently joined a company and i've started going through there confluence wiki to change the branding, formatting and structure. All pages, which have been created, have not used a set template so none of them have a consistent feel. They just started with a blank page template. 

    I have started creating global and space specific templates and would like to know if there is a way to bulk update multiple pages to use the new templates i have created rather than having to it manually in a process I have yet to sort out, but looking very much like creating a new page and copying and pasting content. 

    Has anyone had experience of doing similar or know of a method for doing this?

    Many thanks


    1. Hi Simon, I'm afraid templates are only used when creating pages, there's no way in Confluence to apply a template to an existing page or bulk apply formatting and layout changes in a page.  Sorry to be the bearer of bad news, but it will be a page by page process i'm afraid. 

  9. I think a note should be added to the promote template section that ONLY space templates and blueprints can be promoted. Global templates are grayed out in the promote templates screen and can't be promoted or demoted. There is a feature request for this:  CONF-32450 - Allow Space Admins to 'Promote' the Blank Page Template New

  10. Hi, does anyone know how I can add more team members to the page when I have used a collaboration template? Can't seem to find a way to add new people once the page has been created.

    1. Hi Susan,

      By 'collaboration template' are you referring to a page template, or the 'Team space' blueprint?

      If it's the Team space blueprint, there's no way to add team members per-se, but you can give others permission to administer the space (Space toolsPermissions), and add them to the home page with the User Profile macro.

  11. Hi folk,

    Can anyone help please!

    When going to view or edit a template I created, I am getting the following error:

    Error: [com.ctc.wstx.exc.WstxLazyException] com.ctc.wstx.exc.WstxParsingException: Unexpected '

    It seems to be a known issue -  CONF-25584 - Table of Content Macro gives com.ctc.wstx.exc.WstxParsingException: Unexpected close tag </textarea> expected error Open

    Is there a history for templates whereby I can revert to a previous version?

    On a typical wiki page you can click on Tools -> Page History, but I don't see any history for templates.

    If there isn't any, then my template work is gone & I have lost data (contrary to the defect's 25584 assertion).

    FYI I'm using Confluence version 5.3.1

    1. Hi Albert,

      I'd recommend you speak to support about the error you're receiving, so that they can take a look and at least keep a good record of it.

      On the versioning of templates, the below issue looks like it's asking for this functionality, so I'd recommend watching and commenting on it.

      CONF-5876 - Templates, layouts, user macros etc should be versioned and keep author information Open

  12. As a space admin, not a global admin, I would like to be able to set up a template in footer for any existing or future page and modify the footer whenever it's needed.