Blueprints

What's 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, and Customise the blueprint templates to suit your individual needs. You can even develop your own blueprints. 

Create content using a blueprint

  1. Choose Create from template  in the Confluence header
  2. Select a blueprint from the create dialog
  3. Hit Create

The editor will open, and, depending on the blueprint selected, a prompt to enter information or the page will appear. You can now follow the instructions built in to the blueprint to add content.

On this page:

Related pages:

The first time a blueprint is used in a space, Confluence creates an index page and adds a shortcut to your sidebar (if you're using the default theme). The index displays a list of pages made with the blueprint, and information selected information from your blueprint pages. For example, the meeting notes index displays a list of all meeting notes pages in the space, who created them, and when they were last modified.

Screenshot: Index page for the Meeting Notes blueprint

If you're using the Documentation theme, your blueprint index page(s) will appear in the sidebar as children of the homepage.  

Customise 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 from the bottom of 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:

  • Be careful not to remove any macros that the blueprint page or index page may use to store and display information
  • You can't 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 from the bottom of 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. 

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

Add more blueprints

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

See Request 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.

Disable 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 an 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 from the bottom of 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 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