JIRA Report Blueprint

The JIRA Report blueprint helps you create easy to read reports to communicate the progress of your JIRA projects and releases.

You can choose from a Change Log report that generates a list of JIRA issues or a Status Report that includes charts to visually communicate your progress.

The first time you use the JIRA Reports blueprint in a space, Confluence will create an index page and add a shortcut on your space sidebar (if you are using the default theme).

To use the JIRA Report Blueprint your Confluence and JIRA sites must be connected via Application Links.

On this page:


Related pages:

Creating a Change Log 

The Change Log report displays a list of issues from JIRA. This list can be static or dynamic, automatically updating as the status of your issues change in JIRA. 

To create a static Change Log:

  • Choose Create > JIRA Reports.
  • Select a Report Type.
  • Select your JIRA server.
  • Choose a Project and Fix Version to report on.
  • Choose Create.

A report page will be created with some sample text, and a list of all issues for the project and fix versions selected - organised by issue type. This list of issues is static, it will not be updated when the issues in JIRA are updated, and is visible to users who do not have JIRA access or permissions to view that project. 

Screenshot: Creating a Change Log in simple mode.

Screenshot: Static list of JIRA Issues displaying in the Change Log.

To create a dynamic change log:

  • Choose Create > JIRA Reports.
  • Select a Report Type.
  • Choose Advanced.
  • Enter a JQL query or paste in the URL of a JIRA search.  Find out about using JQL in the JIRA Documentation.
  • Choose Create.

A report page will be created with sample text and a JIRA issues macro that is configured to show your issues. The macro is dynamic and will update when the issues in JIRA are updated.  For more information on how to further change the information displayed, refer to the JIRA Issues macro.  

Screenshot: Dynamic list of JIRA Issues displaying in the Change Log.


Creating a Status Report

The Status Report displays the progress of a JIRA project and fix version in pie charts by status, priority, component and issue type. The Status Report uses the JIRA Chart macro, and is dynamic. 

To create a status report:

  • Choose Create > JIRA Reports.
  • Select Status Report.
  • Select your JIRA server.
  • Choose a Project and Fix Version to report on or enter a JQL query or JIRA URL. 
  • Choose Create.

A report page will be created with sample text and a series of pie charts, using the JIRA Chart macro. The macro is dynamic and will update when the issues in JIRA are updated.  For more information refer to the JIRA Chart macro

As with the Change Log, you can switch to Advanced mode and use JQL or paste in a JIRA URL to search for issues to display in the report. 

Screenshot: Excerpt from the Status Report.

Customising this blueprint

You can customise the templates that are used by this blueprint. The Change Log uses the Snapshot JIRA Report Template (for static list of issues) and the Dynamic JIRA Report Template, and the Status Report uses the Status Report Template. See Customising the blueprint templates.  Variables represent the JIRA Issues and JIRA Chart Macros - while these cannot be edited, they can be moved around the page or deleted if you do not want every chart to be included. 

You might choose to edit the page template to modify the format of the page, change some headings or modify the instructional text. To find out more about using instructional text in a template see - Instructional text

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