Add an Analytics widget to a dashboard

Azure DevOps Services

The Analytics Service is the reporting platform for Azure DevOps. Using Analytics, you and your team can gain new insights into the health and status of your work. Follow this short guide to get started in a few simple steps.

In this topic we walk you through the steps for adding the Analytics-based Velocity widget to a dashboard. For a review of all Analytics-based widgets, see Widgets based on the Analytics Service


Install the Analytics extension

  1. Go to the Analytics Marketplace extension.
  2. Choose to Install the Analytics extension. You might need to sign in with your Azure DevOps Services organization credentials.
  3. Select the Azure DevOps Services organization where you would like to install this extension and confirm. Learn more about Install extensions.

Add the Velocity widget to your dashboard

To add a widget to a dashboard, you connect to your project using a supported web browser. If you need to add a project, see Create a project

  1. Connect to the web portal for your project and choose Overview>Dashboards.

    Web portal, open Dashboards

    If you need to switch to a different project, choose the  Azure DevOps logo to browse all projects and teams.

  2. Choose the dashboard that you want to modify.

  3. Choose  to modify a dashboard. The widget catalog opens.

  4. In the right pane search box, type Velocity to quickly locate the Velocity widget within the widget catalog.

    Velocity widget in widget catalog

  5. Choose the widget, then Add to add it to the dashboard. Or, you can drag-and-drop it onto the dashboard. Learn more on adding widgets to dashboard

Congratulations! A new Velocity widget has been added to your dashboard.


You'll gain the greatest utility from the Velocity widget by assigning work to sprints and completing work defined in those sprints. To quickly define sprints, see Schedule sprints.

Learn about your team's velocity using the Velocity widget

The Velocity widget will help you learn how much work your team can complete during a sprint. The widget shows the team's velocity by Story Points, work item count, or any custom field. You can also compare the work delivered against your plan and track work completed late. Using the Velocity widget, you will be able to answer questions like:

  • On average, what is the velocity of my team?
  • Is my team consistently delivering what we planned?
  • How much work can we commit to deliver in upcoming sprints?

Velocity widget showing 8 sprints of data based on Story Points.

Velocity widget

Here, the Velocity widget shows this team has a history of closing stories late. It also shows a discrepency between planned and completed work in the past 4 sprints. The team can drill into the data to determine the root causes. After implementing new practices, the team can use the Velocity widget to track their effectiveness.

Learn more about the Velocity widget in Configure and view Velocity charts.

Try this next