Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
In this example

Version report

Interactive сhart example
info
The interactive chart is available on larger screens
Please open this page on a desktop to try it out

Key features of the Jira version report

The Version report helps you track throughput and forecast release completion based on velocity trends. Instead of being limited to a single release, you can analyze one or multiple fix versions across projects, compare contributions from different teams, and put performance into context with benchmarks and targets.

With flexible breakdowns, custom calculations, and filtering options, the Agile Velocity Chart Gadget app adapts to any workflow and provides stakeholders with a clear, release-focused view of delivery progress.

How different roles use the Version report in Jira

Product Owner: I use the Jira release report to see how our velocity trends impact delivery timelines, helping me forecast feature completion and set realistic expectations with stakeholders.

Technical Team Lead: I use the breakdown by project, board, or assignee to see how my team contributes to a shared release and to catch any bottlenecks early.

Delivery Manager: I monitor throughput across multiple releases and projects, using benchmarks and target lines to ensure consistent velocity and keep multiple teams on track toward shared milestones.

Product Manager: I rely on the Jira version report gadget to validate that roadmap items tied to releases are progressing, and I use filtering to focus only on the scope I own.

Portfolio manager: I compare releases across ARTs and projects to assess whether delivery velocity supports our portfolio-level investment priorities.

Transform release chaos into clarity with VERSION REPORT

1. Key feature: Release-based velocity tracking

Use fix versions as the data source to build a velocity chart focused on releases instead of boards. This allows you to analyze the throughput delivered toward a release and forecast its completion date based on past velocity trends. You can select one or multiple releases, even across different projects.

Jira version report example for multiple releases

The “Release-based velocity tracking“ feature is helpful for:

  • Verifying that releases are on track and communicating project timelines.
  • Aligning multiple teams or ARTs delivering into the same release.
  • Gaining visibility into how scope completion aligns with roadmap expectations.

2. Key feature: Breakdown by release, project, or team

Click on a sprint or interval (1️⃣) in the Version chart in Jira to open a detailed breakdown. You can compare throughput across individual releases (2️⃣) or projects and see how different teams contribute to the overall delivery. The breakdown fields are fully customizable - group by assignee, board, label, or any other Jira field (3️⃣). At any level of nesting, you can drill down further into the Issue list (4️⃣) to view the exact issues included in the metric and even edit them directly from the Version report.

Breakdown by release in the Jira version graph

The “Breakdown” feature is helpful for:

  • Comparing releases and seeing how multiple teams contribute to shared outcomes.
  • Analyzing contributions at the board or assignee level.
  • Accessing the underlying issues to validate the scope or make adjustments.

3. Key feature: Benchmark and target lines

Use horizontal reference lines in the Version report in Jira to put throughput into context. Display a line for the median or average (1️⃣), customized over a chosen number of past sprints. You can also add target lines (2️⃣) to track KPIs or delivery goals, making it easy to spot whether teams are meeting expectations.

Average and target lines in the version chart in Jira dashboard

The “Benchmark and target lines” feature is helpful for:

  • Measuring consistency against past performance.
  • Aligning throughput with organizational KPIs.
  • Tracking progress against roadmap targets and commitments.

4. Key feature: Customize chart calculations

Tailor the velocity Release velocity chart to match your team’s workflow and reporting needs:

  • Select a custom estimation field - story points, issue count, effort, or any other field available in your Jira instance.
  • Define a default estimate for items without estimation to avoid skewed results.
  • Choose one or multiple statuses to be treated as Done, ensuring the chart reflects your actual workflow.
Custom calculation settings in the release report in Jira

The “Custom calculations” feature is helpful for:

  • Teams using non-standard estimation fields who want consistent reporting.
  • Ensuring unestimated issues don’t distort throughput metrics.
  • Adapting the chart to workflows where “Done” differs across projects or teams.

Additional features of Jira version report  

1. Issue filtering

Filter the work items included in the chart scope to focus on the data that matters most. You can narrow the view by issue type, epic, or apply custom JQL for complete flexibility.

Filter issues in the versions graph in Jira

2. Export to CSV, PNG, or PDF

Share or archive your insights outside of Jira. Export the Release velocity chart data to CSV for further analysis, or generate ready-to-use PNG and PDF files for reporting and presentations.

Export settings of the version report for Agile releases

Export settings of the version report for Agile releases

What about the native Version report in Jira

Jira comes with built-in Version Report and Release Burndown, but their focus is on burnup and burndown views rather than velocity. They also have significant limitations:

Each chart is restricted to a single release, cannot group data by time interval instead of sprint, and lacks breakdown options by project, issue type, or other fields.

Customization is limited - you cannot adjust the estimation field, Done statuses, or the displayed period.

Native Jira reports don’t support visual benchmarks or target lines, issue filtering, or switching to a line view to spot velocity trends.

Advantages of using the Version report

The Version report by Broken Build extends Jira’s reporting with:

  • Multi-release view: track one or multiple releases across projects.
  • Flexible breakdowns: group throughput by release, project, team, assignee, or any Jira field.
  • Customizable calculations: choose estimation fields, Done statuses, and default estimates.
  • Benchmarks and targets: add median/average lines and KPI target lines for context.
  • Advanced filtering: focus the chart on specific issue types, epics, or JQL queries.
  • Multiple views: switch between bar and line views to highlight trends.
  • Export options: share insights via CSV, PNG, or PDF.
Explore the interactive chart, no setup, no risk
TRY THE CHART
Chart embeded

Apps used in this Jira version report example

Use our examples to build your use cases on the Jira Dashboard.

Both Jira apps (plugins) used in these examples have a 30-day free trial and are completely free for teams under 10 people:

The Agile Reports and Gadgets app also includes Jira version report functionality and a multitude of other reports/charts.

Frequently Asked Questions

1. Can I compare releases from different projects in the same chart?

Yes. You can select one or multiple releases from different projects as the data source and use the breakdown feature to group results by release or project. It’s also possible to apply custom JQL filters to refine the scope. The Jira version chart updates instantly to reflect your selections.

Track progress for multiple releases in Jira

2. What estimation fields can I use to measure velocity in a release?

By default, the Version report in Jira uses story points, but you can select any estimation field available in your Jira instance, such as issue count, effort, or business value. You can also define a default estimate for items without estimation to keep the velocity calculation accurate.

3. How does the Version chart gadget help to predict the release date?

The Version report gadget shows how much work is completed toward each release and what the team’s average velocity looks like. You can use this data together with your own release plan to estimate when the remaining work is likely to be finished. For date-based forecasting, you can also use the Release Burndown report included in the Agile Reports and Gadgets bundle by Broken Build.

4. How do I interpret a sudden spike or drop in throughput?

A spike may occur when many small or previously blocked issues are completed at once. A drop can signal blockers, underestimation, or work on non-estimated items, which the chart counts as zero story points by default. To identify the cause, try switching the estimation field to issue count or using the breakdown and issue list to investigate further.

Why trust Broken Build apps?

Gold Marketplace Partner
apps