Working with Blueprints

What is a blueprint?

A blueprint is a set of page templates with added functionality to help you create, manage and organise content in Confluence more easily.

Create meeting notes, shared file lists and requirements documentation out of the box. Customise the blueprint templates to suit your individual needs.You can even develop your own blueprints.

Creating content using a blueprint

You create a page from a blueprint in the same way as other pages in Confluence.  All blueprints are different and most contain instructions to guide you.

To create a page from a blueprint in the current space:

  1. Choose Create on the header.
  2. Choose a blueprint from the 'Create' dialog.
  3. Choose Create.
  4. The editor will open, a prompt to enter information, or the page will appear, depending on the blueprint selected. You can now follow the instructions built in to the blueprint to add content.

The first time a blueprint is used in a space, Confluence creates an index page and adds a shortcut to your sidebar (if you are using the default theme). The index shows information from your blueprint pages, for example the meeting notes index displays a list of all meeting notes pages in the space. 

Screenshot: Index page for the Meeting Notes blueprint

If you are using the Documentation theme, your blueprint index pages will appear in the sidebar as children of the homepage. 

Screenshot: Index page for the File List blueprint with the Documentation theme applied to the space


Customising blueprint templates

Blueprints are made up of templates that can be customised for an individual space or the whole site. This means you can adapt the content of the blueprint pages to suit your specific needs. For example, you might update the Meeting Notes blueprint templates to include a heading for apologies.

If you have space administrator permissions, you can customise blueprint templates for the spaces you are an administrator of. You must be a Confluence Administrator to customise blueprint templates for a whole site. See Administering Site Templates for more information.

To customise a blueprint template for a space:

  1. Go to the space and choose Space tools > Content Tools on the sidebar. 
  2. Choose Edit beside the blueprint template you wish to edit. 
  3. Make your changes to the template and choose Save.

Editing a blueprint template is very similar to editing a page template except:

  • You should be careful not to remove any macros that the blueprint page or index page may use to store and display information. 
  • You cannot remove a blueprint template or change the template name.

To reset a blueprint template back to the default:

  1. Go to the space and choose Space tools > Content Tools on the sidebar. 
  2. Choose Reset to default beside the blueprint template you wish to reset. 

See Working With Templates and Administering Site Templates for more information on templates. 

As with user created space and site templates, editing a blueprint template will not change existing pages, but any new blueprint pages will be based on the updated template. 

Promoting blueprints 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. 

Adding more blueprints

You can find more blueprints for Confluence in the Atlassian Marketplace. Blueprints are managed using add-ons (also known as plugins). 

See Requesting Add-ons for information on how you can search for new blueprint add-ons and send a request to your System Administrator. 

If you are a System Administrator, see Managing Add-ons or Plugins for information on how to install new blueprint add-ons. 

You can also develop your own blueprints. See our developer documentation on Writing a Blueprint.

Disabling a blueprint

You may want to disable particular blueprints. For example, you may not want to see the Product Requirements blueprint in the Create dialog in a HR or Social space. If you are a Confluence Administrator you can also disable particular page and space blueprints for the whole site.

To disable a blueprint in a space:

  • Go to the space and choose Space tools > Content Tools on the sidebar. 
  • Choose Disable next to the blueprint you wish to disable in that space.

You can re-enable the blueprint at any time.

To disable a blueprint across a whole site:

  • Choose the cog icon , then choose General Configuration under Confluence Administration. You need Confluence Administrator permissions to do this.
  • Choose Global Templates and Blueprints.
  • Choose Disable next to the page or space blueprint you wish to disable.

The blueprint will not appear in the 'Create' or 'Create Space' dialogs.

Full list of blueprints

Here's the full list of blueprints that are bundled with Confluence.  

Page blueprints Space blueprints
  • Documentation space
  • Team space
  • Knowledge base space

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport