Help Center
Note: Zenhub's full feature set is unlocked when you connect your GitHub Organization to Zenhub

About velocity charts

Successful development starts with a solid plan. But when time, budget, and quality are fixed, as they are in agile software development, how can you predict the scope of work your team can accomplish in a sprint?

The answer, of course, is historical data. Velocity charts are an agile tool that displays a team's historical speed of work. At a glance, you're able to see exactly how much value your team can ship each sprint.

People tend to overestimate how much they can get done in a given time period, resulting in missed deadlines and frustrated teams. Using learnings from our velocity charts, we're able to make much more accurate goals.

In isolation, the amount of work completed in one Zenhub sprint isn't very helpful. Factors outside your control – like illness, meetings, or holidays – are certain to pop up. But viewed over a period of weeks, this data provides valuable insight.

Velocity charts reveal how much work you can reasonably commit to, which is especially helpful when planning sprints. And because they only use real GitHub data, there's no question as to whether the information is accurate.

How does the velocity chart get created?

By using Zenhub sprints, and sprint planning in your workflow, the velocity chart will naturally build itself! As you close out sprints, the average velocity will automatically be calculated.

The Zenhub velocity chart will populate with the 7 most recent closed sprints, and display the next 3 upcoming.

How to read agile velocity charts

If you haven't already, start adding story point Estimates to your GitHub issues and PRs. Velocity Charts display the total number of estimates completed in your recent sprints 

To access the charts, select “Velocity tracking” in Zenhub's Reports tab. The chart will automatically display both open and recently closed sprints, and you can hover over each bar to see more detail.

If you have connected repositories together, your Velocity Charts will pull in data from more than one GitHub repo – giving you an even more accurate idea of your speed.

Using labels on the velocity chart

Adding labels to the velocity chart allows teams to break down how many story points were closed sprint-over-sprint using a subset of data. This gives additional insight on how team efforts have been spent over the last sprints.


Using label tracking, teams will be able to detect trends to improve processes, increase productivity, and stay agile. For example, adding the bug and urgent labels to your velocity report provides answers to questions, such as “How much of our time was spent addressing urgent bugs over the last few sprints?” or “How has our new QA/Code Review process been working to address bugs before releasing?”

More insights empower teams to take action and stay agile, encouraging continuous improvement.

Filter out sprints for more accurate averages

Velocity Charts are meant to provide insights on how much work your team can realistically tackle. During short sprints of work, holidays, spikes to set up projects, or other downtimes, it's important to filter these time periods out of your average velocity to truly reflect the capacity of your team.

Filter these sprints from your velocity report to accurately resource plan and ensure continuous improvement is part of your agile workflow.  Simply click on the checkbox next to each sprint in the list at the bottom of the chart:

Export your velocity report

When viewing a velocity chart, you can export the report to CSV to further customize and analyze data. To export the report, navigate to your velocity chart where there is an Export to CSV option located in the top right of the report page next to the report title:

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.