---
title: "Velocity"
canonical: "https://support.appfire.com/space/FD/1802666057/Velocity"
format: markdown
---
> Macro (aura-html)

Velocity is the total number of story points associated with completed tickets.

## Which reports use Velocity?

See Velocity in [Metrics overview](https://appfire.atlassian.net/wiki/spaces/FD/pages/1802633465), [Retrospective](https://appfire.atlassian.net/wiki/spaces/FD/pages/1802207573), and [Check-in](https://appfire.atlassian.net/wiki/spaces/FD/pages/1802633537).

See the story points associated with each ticket in [Sprint movement](https://appfire.atlassian.net/wiki/spaces/FD/pages/1802043684) and [Ticket log](https://appfire.atlassian.net/wiki/spaces/FD/pages/1802567912).

## What does Velocity measure?

Velocity helps you understand your team's throughput by measuring the number of story points associated with completed tickets. While this is not a comprehensive measure of the quantity of work you're completing, it's a useful metric to help you understand your throughput patterns, especially if your teams share a strategy for assigning story points to tickets.

## How is Velocity calculated?

Velocity is the total number of story points associated with tickets that moved to their final **Done** status during the selected timeframe.

> ℹ️ If a ticket previously in a **Done** status moves to a new **Done** status, the completion date for the ticket updates to the date of the most recent **Done** status, and the story points associated with the ticket are removed from any previous Velocity counts.

## What data is included in Velocity?

> ℹ️ To calculate Velocity correctly, Flow needs to access the field that stores your story point information. Flow uses [these fields by default](https://appfire.atlassian.net/wiki/spaces/FD/pages/1802633609/Troubleshooting+ticket+data#Troubleshooting-story-points-in-Flow). If you use a custom field for your story point information, set up custom mapping for story points in your ticket project configuration. Typically, velocity will be zero when you need to update your story point mapping.

Tickets are included in Velocity if:

- They are in a **Done** status according to the [ticket project configurations](https://appfire.atlassian.net/wiki/spaces/FD/pages/1802010869)
- They were moved to their most recent **Done** state during the selected timeframe
- The selected user or a member of the selected team was an assignee on the ticket at any point after it moved into its first **Active** status

Tickets are not included in Velocity if:

- They are in a **Canceled** status
- They have not been moved to a **Done** status or were not moved to a **Done** status in the selected date range
- The selected user or a member of the selected team was never an assignee on the ticket or was only an assignee in an **In progress** status
- They were moved to a different **Done** state after the selected date range
- Their issue type is excluded as part of ticket type assignment in the [ticket project configurations](https://appfire.atlassian.net/wiki/spaces/FD/pages/1802010869)