Last updated Feb 23, 2024


insert menu

What are blueprints?

Confluence blueprints give users a way to create pages based on pre-defined content. Users can select from available blueprints in the Create dialog, and as an app developer you can add your own blueprints to this dialog. Basic blueprints create pages from static templates, while more advanced ones create dynamic content from templates that have variable placeholders that are loaded with data from your app.

What can I build with blueprints?

New content with a macro

If your app provides a macro, an obvious use of a blueprint is to create a new page with an instance of it (as described in the macro pattern). This is a great way of increasing visibility for any macros that are part of your app.

Pages with instructions for the user

Blueprints allow you to create temporary placeholder text for users to replace with their own content. This can be helpful in guiding users when creating standardized pages with dynamic content.

Multiple pages

Using Confluence's REST APIs, you can turn the creation of one page from a blueprint into the creation of a series of pages. This is useful for "packs" like:

  • Employee on-boarding packs
  • Competitive analysis packs

How do I build blueprints?

Create a static blueprint

The simplest form of a blueprint is one which provides content to Confluence from the app. Confluence stores this content which is used to create new pages.

Dynamically replace content when a page is created (optional)

You might need to generate or replace content with your app when a page is created from your blueprint. This can be done by including variables in your original static template and providing content for the variables when the page is created.

What other patterns might be helpful?


Macros are a relevant pattern if your app is implementing a "macro creation blueprint" as discussed above.

Let's do this!

Get going by following our Creating a multi-page blueprint tutorial and referring to related documentation listed on the right hand side of this page.

  • Diagramming
  • Integrations
  • Macros

Rate this page: