Scrum Velocity Chart: How It Works in Jira and How to Use It for Sprint Planning


Scrum Velocity Chart: How It Works in Jira and How to Use It for Sprint Planning

Quick answer

A Scrum velocity chart shows how many story points a team completed in each sprint over time. In Jira, it is available under Reports on any Scrum board. It is used to calculate average velocity and set realistic sprint commitments. Jira’s native chart shows team-level totals only — it cannot be broken down by individual user or filtered by issue type.

Velocity is one of the most used — and most misused — metrics in Scrum. Used correctly, the velocity chart is the most practical input for sprint planning. Used incorrectly, it becomes a pressure tool that distorts estimation and erodes team trust.

This guide explains what the Scrum velocity chart actually shows, how to read and use it in Jira, how to calculate average velocity correctly, and where the native chart stops being sufficient.

Related: Jira Scrum Reports: Burndown Chart, Velocity Chart, Sprint Report and Agile Reports Explained — overview of all four native Scrum reports in Jira.

What Is a Scrum Velocity Chart?

A Scrum velocity chart is a bar chart showing how many story points — or other estimation units — a team completed in each sprint, displayed across a series of consecutive sprints. Each bar represents one sprint. The height of the bar represents the amount of work completed.

According to the Scrum.org definition, velocity is the amount of work a Scrum team completes during a single sprint, measured consistently using the same estimation unit across sprints. It is a team metric used for planning — not a performance measurement.

The velocity chart serves one primary purpose: giving the team a data-based foundation for deciding how much work to commit to in the next sprint.

How to Access the Velocity Chart in Jira

  1. Go to your Jira Software project
  2. Click Reports in the left sidebar
  3. Select Velocity Chart

Jira displays the last completed sprints automatically, typically showing the most recent 7 sprints. The chart is only available on Scrum boards in Jira Software projects. It is not available on Kanban boards or Jira Work Management projects.

If you do not see Reports in the sidebar: you are on a Kanban board or a Jira Work Management project. Switch to a Scrum board to access the Velocity Chart.

How to Read the Jira Velocity Chart

Each bar in Jira’s Velocity Chart shows two values for the same sprint:

  • Commitment (grey bar): the total story points added to the sprint when it was started
  • Completed (coloured bar): the story points actually finished — issues moved to Done — by sprint end

The gap between commitment and completed is the most informative part of the chart. Here is what different patterns mean:

Pattern What it means What to do
Completed consistently below commitment Team is regularly over-committing Reduce next sprint commitment to match actual completed average
Completed consistently above commitment Team is under-committing or pulling in unplanned work Increase commitment slightly — review whether unplanned work is being tracked
Commitment and completed roughly equal Healthy estimation accuracy Use this sprint’s completed value to update rolling average
One sprint with unusually low completed Outlier — holidays, incidents, or team changes Exclude from average calculation or note the reason
Steadily increasing completed over time Team is improving or growing Recalculate average using only recent sprints to avoid underplanning

How to Calculate Average Velocity in Scrum

Average velocity is the number you use as the basis for sprint planning. Here is how to calculate it correctly:

  1. Take your last 3 to 5 completed sprints from the velocity chart
  2. Note the completed story points for each — not the commitment
  3. Add them together and divide by the number of sprints

Example: if your team completed 34, 41, 38, 36, and 40 story points over five sprints, your average velocity is (34 + 41 + 38 + 36 + 40) ÷ 5 = 37.8 story points per sprint.

Use this number as the upper boundary for the next sprint’s commitment — not a target to exceed.

How many sprints to include in the average

Most Scrum practitioners use 3 to 5 sprints. Using fewer than 3 makes the average sensitive to outliers. Using more than 7 may include data from when the team was larger, smaller, or using different estimation practices — making the average less representative of current capacity.

Exclude obvious outliers — sprints affected by public holidays, major incidents, or significant team changes — and note why they were excluded so the decision is visible to the whole team.

Using Velocity for Sprint Planning

Velocity informs sprint planning in one specific way: it tells the team the realistic ceiling for how much to commit to. The process:

  1. Calculate average velocity from the last 3–5 sprints as above
  2. Account for capacity changes — team members on leave, new joiners, or known interruptions in the upcoming sprint
  3. Adjust the commitment proportionally: if average velocity is 38 and one team member is on leave for half the sprint, reduce commitment by roughly their proportional share
  4. Pull items from the top of the backlog until you reach the adjusted commitment ceiling
  5. Do not add more work to “fill the sprint” if you reach the ceiling — stop there

Velocity vs. capacity: the difference

Velocity is historical — what the team actually completed. Capacity is forward-looking — what the team has available in the next sprint based on who is present and for how many days. Velocity informs capacity planning but they are not interchangeable. A sprint where two team members are on leave will have lower effective capacity than average velocity suggests, regardless of what the chart shows.

What the Jira Velocity Chart Cannot Show

Jira’s native Velocity Chart has three significant limitations that matter as teams grow:

No velocity by individual user or assignee

The chart shows team totals only. You cannot filter or break it down by assignee. This is by design — velocity is a team metric in Scrum, not an individual one.

That said, some teams legitimately need to understand workload distribution at the individual level for capacity planning purposes — not for performance evaluation, but to balance work and identify bottlenecks. For that use case, Report Hub provides a per-user velocity breakdown inside Jira Cloud.

Before using individual velocity data: read our guide on the risks of tracking velocity per user — Do Agile Teams Really Use Velocity per User in Jira? Myth and Reality. Individual velocity data is easy to misuse and can damage team dynamics if applied without clear intent and team agreement.

No velocity by issue type or label

You cannot separate bug velocity from feature velocity, or planned work from unplanned work. If your team consistently takes on a significant volume of unplanned bugs during sprints, the velocity chart averages that in without making it visible. Teams that want to understand this split typically use a custom dashboard gadget or a reporting add-on.

No Kanban velocity chart

Jira’s native Velocity Chart only works for Scrum boards. Kanban boards have no sprints, so Jira does not calculate velocity for them. Teams using Kanban typically use throughput — issues completed per week — as the equivalent planning metric. For teams that want a Kanban velocity chart in Jira, this requires a reporting add-on such as Report Hub.

Velocity Chart on a Jira Dashboard

Jira allows you to add a Velocity Chart gadget to a dashboard so the team can monitor it alongside other sprint metrics without navigating to the Reports section separately.

How to add it: Go to Dashboards → your team dashboard → Add gadget → search for “Velocity Chart” → configure it to your board. The gadget updates automatically as sprints are completed.

For a full walkthrough on building a Scrum dashboard with multiple report gadgets in one view, see: How to Create a Custom Dashboard in Jira.

Common Velocity Chart Mistakes to Avoid

  • Using velocity as a performance target. Telling the team their velocity needs to increase treats a planning metric as a productivity target. This incentivises inflating story point estimates, which destroys the metric’s usefulness over time.
  • Comparing velocity across teams. Different teams estimate differently, work on different types of problems, and have different team sizes. Velocity numbers are not comparable across teams and should not be used that way.
  • Not excluding outliers. A sprint with a public holiday, a major incident, or two team members on leave will produce an artificially low velocity. Including it in the average without noting the cause will lead to under-planning in future sprints.
  • Using commitment instead of completed. Always base your average on the completed bar, not the commitment bar. Commitment reflects intent; completed reflects reality.
  • Planning to exactly hit average velocity. Average velocity is a ceiling, not a target. Plan slightly below average to account for variability and leave room for unplanned work.

FAQ: Scrum Velocity Chart in Jira

What is a Scrum velocity chart?

A Scrum velocity chart is a bar chart that shows how many story points a team completed in each sprint over a series of consecutive sprints. It is used to calculate average team velocity and set realistic commitments for future sprints. In Jira, it is available under Reports on any Scrum board.

How do I access the velocity chart in Jira?

Go to your Jira Software project → click Reports in the left sidebar → select Velocity Chart. It is only available on Scrum boards in Jira Software projects — not on Kanban boards or Jira Work Management projects.

How do you calculate average velocity in Scrum?

Add up the story points completed across your last 3 to 5 sprints and divide by the number of sprints. For example: (34 + 41 + 38 + 36 + 40) ÷ 5 = 37.8 story points per sprint. Use completed story points — not commitment — and exclude outlier sprints affected by holidays or significant team changes.

What is the difference between velocity and capacity in Scrum?

Velocity is historical — how much the team actually completed in past sprints. Capacity is forward-looking — how much the team can take on in the next sprint based on current availability. Velocity informs capacity planning but a sprint where team members are on leave will have lower capacity than average velocity suggests.

Does Jira show velocity by user or assignee?

No. Jira’s native Velocity Chart shows team-level totals only and cannot be filtered by individual user or assignee. To see velocity per person, you need a reporting add-on such as Report Hub.

Does Jira have a velocity chart for Kanban boards?

No. Jira’s Velocity Chart is only available on Scrum boards. Kanban boards have no sprints so Jira does not calculate velocity for them natively. Teams typically use throughput — issues completed per week — as the Kanban equivalent. For a Kanban velocity chart inside Jira, a reporting add-on is required.

Why is my Jira velocity chart showing zero or no data?

The Velocity Chart requires at least one completed sprint with estimated issues. Common causes: no sprints have been completed yet, issues were not estimated before the sprint started, or the board’s estimation statistic is set to a field with no values. Check Board → Configure → Estimation to verify the estimation field is set correctly.

How many sprints should I use to calculate velocity?

Use the last 3 to 5 completed sprints. Fewer than 3 makes the average sensitive to outlier sprints. More than 7 may include data from periods when the team composition or estimation practices were different, making the average less representative of current capacity.

Summary

The Scrum velocity chart is a sprint planning tool, not a performance metric. Its job is to give the team a data-based answer to “how much should we commit to next sprint?” — based on what they have actually completed recently, not on what they hope to achieve.

In Jira, it lives under Reports on any Scrum board, updates automatically after each sprint, and requires no configuration beyond having estimated issues in completed sprints. Its main native limitation is that it shows team totals only — no breakdown by user, issue type, or project.

For the full picture of Scrum reports available in Jira, see: Jira Scrum Reports: Burndown Chart, Velocity Chart, Sprint Report and Agile Reports Explained.

For time tracking within sprint context alongside velocity data, see: Jira Time Tracking Reports: What’s Built In and What’s Missing.

Try Report Hub free on the Atlassian Marketplace →

Read more interesting articles

Ready to Elevate Your Jira Setup?

Partner with Grandia Solutions to unlock expert configuration, reporting, and support services — tailored to your workflows. Whether you need custom dashboards, workflow automation, or long-term consulting, our team is here to make Jira work for you.

Leave your details and we will contact you as soon as possible

    Discover more from Grandia Solutions

    Subscribe now to keep reading and get access to the full archive.

    Continue reading