Velocity’s newest module, Workstreams, displays Git and Jira data in concert, to help engineering managers and tech leads walk into stand-ups with a richer understanding of the health and progress of their team.

The Workstreams Index Page

When your JIRA connection is enabled, Workstreams will populate the index page with active sprints from imported JIRA projects, and JIRA boards that you added to your team in the Velocity Settings page (See FAQ for troubleshooting below).

Note: Velocity Admins will be able to see all Sprints and Boards for an organization in the Workstreams index page.

The Workstreams Detail Page

For Scrum boards, the sprint header on the top right gives users an immediate view of the date range of the sprint and days remaining, so they can get a sense of how much time their team has left and whether or not they need to prioritize or cut scope. For Kanban boards, the header will display a Work-In-Progress indicator showing how many issues are in progress and the average number of issues per assignee.

Filter by People, Issue Type (task, story, bug), Status (your list of statuses is imported from Jira), and Epic using the dropdown menus below the sprint header. This enables engineering managers to quickly review who is working on what and where certain tracks of work sit within the pipeline.

Below, the report is organized into the following 7 columns:

  • Issue title: The title of the issue, as labeled in Jira. Clicking into any issue title will bring up a drill-down of all associated PRs (and links to the respective PRs in your VCS), so managers can dig deeper into specific units of work.

  • People: A facepile of all the team members working on a given issue. The first Avatar is the Issue assignee. Any avatars after that are contributors on pull requests linked to that issue.

  • Effort: This column ranks the Effort of any given issue on a scale of 1 to 5. Effort is a proprietary metric that estimates the amount of time spent on an issue based on the coding activity associate with the issue over its lifetime. An engineering manager can use this data to get a sense of the magnitude/importance of any unit of work.

  • Branches: Displays how many open and merged branches are associated with each issue. Git Branches (Active, Merged, and Branches without PRs).

  • Activity: A chronological view of all commits in a given sprint, with the size of the bubble relative to Impact. Hovering over the bubbles will display the specific commits, as well as how many lines of code were added or removed.

  • Status: The status of the issue and the time it’s spent in that state.

  • Risk: All potentially risky work is flagged in the Risk column, with a red alert symbol. Hovering over the exclamation symbol will display which PR is associated with the risk and why. Managers can use these alerts to spot potential blockers and help their team take corrective action early.


Why can't I see my boards from JIRA in the Workstreams Index Page?

The board you are looking for may not be added to your team in Velocity.

  1. Go to Velocity Settings and select the People Page

  2. Select a team and then navigate to the Boards tab

  3. Select the boards you want visible for your team in Velocity

  4. Press save

Did this answer your question?