Template vs Blueprint

Can someone shed some light, please, on what the difference is between a page template (classic Confluence functionality) and a blueprint? Seems to be the same thing.

7 answers

This is the difference based on my experience



Title can be pre-populated For e.g. dynamic dates in minutes page

Title is Blank

UX Wrapper to pre-populate content dynamically in the page and have macros

No UX Wrapper, but can have pre-written/designed content and end user macros

Needs more development efforts

Needs less development effort. Faster to create.

Creates Index/Report page if Page Properties are included in the blueprint

Does not create any index


Our company is ISO9001:2015 certified and we started to use Confluence in 2013. We had the Vision to do all our documents within Confluence: contracts, offers, specifications, etc. But our customers still want Word documents and PDFs. So we had to find a way to get all your Word Templates into Confluence. With Confluence templates you can do only one page templates and that was a Show stopper. Blueprints can only be improved by a very small number of employees and that is not collaboration! So in the beginning we used the Plugin Copy Page Tree. It worked, but we were looking for a better way.

So we decided to write our own plugin called Page Tree Creator. The following table describes how we see the difference between the solutions.

If you want to see our Page Tree Creator in action, checkout our live examples under this link:



Feature / FunctionPage Tree CreatorCopy Page TreeBlueprintsTemplate
Page Trees are supportedticktickminusminus
Search & Replace in Page Titletickticktickminus
Search & Replace in Page Contenttickminus



Search & Replace in Macro Parameterstickminusminusminus
Search & Replace in Label Fieldstickminusminusminus
Copy attachmentsticktickminusminus
Default Tags (variables, e.g. current user, template Version,...) tick minus tick tick 
No Programming Skills needed, so everybody can improve templatesticktickminustick
Create Index / Report page based on Page Propertiestickminustickminus

Button with source and destination link to create new Page / Page Tree

Cascade Creation of Multi-Page Treestickminusminusminus
No need of Administration Permisson for the design of Page Tree Templatesticktickminusminus
Page restrications are copiedticktickminusminus

Standard Confluence links behind Buttons: Renaming and rearrangement of template pages works like everywhere in Confluence

Tag Markers can be configuredtickminusminusminus
Typed Input Fields (user picker is done, date, time, etc. will follow)( tick )minustickminus

Copy published Comala Pages

Copy Page Tree without Search & Replaceticktickminusminus

Create Space and copy Page Tree: Use our plugin Space Tree Creator 

( tick )minusminusminus

Internationalization of Page Trees

tick, build Page Tree per languagetick, build Page Tree per languageminusminus
Internationalization of one Pagetick, build a Page per languagetick, build a Page per languageticktick




This looks awesome. Thanks for making this. I was about to have to create this, or a version of it. Do you have developer documentation on how to use and extend this?

templates are somewhat limited, with blueprints you can build a fully customizable wizard for your Jira pages. Look at what the polls plugin does with blueprints


One difference I have noticed is that with Blueprints, you can specify what you want the title of the page to be and add variables. Ex. if you create a page with the Meeting Notes blueprint, your page is automatically titled " Todaysdate Meeting Notes."

As far as I know, you can't do that with templates. When you create a new page from a template, you have to manually enter the name of the new page:

TLDR; A blueprint is a template with extra sugar.

Like 1 person likes this

It says in the doc that "A blueprint is a page template with added functionality to help you create, manage and organise content in Confluence.". Can you, please, give an example of such functionality? So far I see a blueprint as just a large template that can include several simple page templates... Am I right?


I invite you to look at the Gaia for JIRA plugin, which basically allow to create new spaces based on a template space. It has got several templates included, and it includes blueprints as well. This allows basically to have a broad set of Confluence pages, and blueprints. So anyone can start a new project based on an predefined environment. Pretty neat.

Yes, concrete examples would help me understand that statement as well!

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Mar 12, 2019 in Confluence

Confluence Admin Certification now $150 for Community Members

More and more people are building their careers with Atlassian, and we want you to be at the front of this wave! Important Dates Start the Certification Prep Course by 2 April 2019 Take your e...

1,154 views 2 13
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you