Skip to main content

Using the Progress Dashboard

Learn how to monitor delivery health, track progress across your backlog, and surface the insights that matter most to your team and stakeholders

Written by Maayan Ayalon

The Progress Dashboard gives product leaders and their teams a live, visual snapshot of how work is progressing across items, products, teams, and timeframes. As work moves through statuses, the dashboard updates automatically. No exports, no manual updates, no status meetings spent reconstructing what is already in the data.

It is designed to answer two questions at a glance:

  1. How far along are we?

  2. What is driving that progress?

The progress wheels show completion, not distribution. They tell you how much of a group is done, not how much of your work falls into each category. To see the share of items by category, such as Foundational versus Innovation, group a Swimlanes or Table view by that field instead.


Before you begin

You will need:

  • A plan that includes the Progress Dashboard. It is available on Enterprise and Trial plans. If you see a yellow lightning bolt next to the view name, your current plan does not include it. Reach out to your Customer Success Manager to discuss access

  • Your statuses set up with the right categories and completion percentages. Progress is calculated from them, so see Configuring your workflow and statuses and How statuses drive progress if you have not set these up yet

  • For the Numerical method: a numeric field on your items, such as Story Points


Creating a Progress Dashboard

The dashboard is available at two levels:

  • Workspace - shows progress for work items (Epics, Features, Stories) within a single Workspace. Best for team check-ins, sprint reviews, and quarterly reporting

  • Portfolio - shows progress across multiple Workspaces. Best for leadership reporting, Initiative tracking, and cross-team visibility

Follow these steps:

  1. Navigate to your Workspace or Portfolio

  2. Click + New View at the bottom of the view list

  3. Select Progress Dashboard from the menu

  4. Start from the default view and customize it to your needs


How progress is calculated

Progress rolls up automatically from child items to their parents. You do not need to update anything manually. The rollup follows the Craft.io item hierarchy:

  • Stories drive Feature progress

  • Features drive Epic progress

  • Epics drive Initiative progress

At the item level, completion is driven by each item's status.

Every status has a calculated progress percentage, set in Workspace Settings → Statuses → Workflow & statuses.

By default, statuses in Open and In progress count as 0%, and statuses in Done and Closed count as 100%. An item in a status set to 50% contributes 50% to its parent's progress. To change a percentage, see How statuses drive progress.

💡 Connected to Jira, Azure DevOps, or Linear? With status mapping set up, Craft.io statuses update as your engineers move work, so the Progress Dashboard reflects delivery without manual updates.


Choosing a calculation method

The Progress Dashboard supports two calculation methods. You can switch between them at any time without affecting your underlying data. The method you choose applies to both item progress and group progress in that view.

  • Simplified - calculates progress based on item count. Every item is treated as equal in weight, regardless of size or complexity, and all of an item's descendants are counted, not just its direct children. Use it for high-level executive reporting, or to see how many items are left to reach completion in a sprint

  • Numerical - calculates progress using a numeric field such as Story Points or Impact. Items with higher values contribute more to the parent's progress. Use it when items vary significantly in size, for example to see whether each developer is on track against their estimates over a sprint

Follow these steps:

  1. Open your Progress Dashboard

  2. Click View settings

  3. Under Progress calculation method, select Simplified or Numerical

  4. If you selected Numerical, choose the numeric field to use as the weight, for example Story Points


Grouping and breakdowns

Grouping defines the primary structure of the dashboard and determines what question it answers at a glance. Common grouping options:

  • Quarter or Release - to see how work is tracking across planning periods

  • Product - to see progress by product area

  • Initiative - to see how major efforts are progressing

  • Objective or Key Result - to see how delivery maps to your strategic goals

Within each group, add a breakdown to segment progress further and see what is driving the numbers. You can break down by Status, item type, Assignee, Priority, or any custom selection field.

Grouping and breakdown work together. Group by Initiative and break down by Status to see how many items in each Initiative are in progress, blocked, or complete. Group by Objective and break down by Key Result to see how delivery effort maps to your strategic measurements.


Drilling down from the Dashboard

The Progress Dashboard is also a navigation tool.

Click a progress wheel or a breakdown segment to open the underlying items, with the same grouping and filters already applied. You can also hover over a breakdown title and click Drill down to open its item table. You move from a high-level insight to the specific items behind it in one click, without configuring a separate view.

For example:

  • Click an Initiative showing 45% progress to see which Epics are complete and which are holding it back

  • Click a breakdown segment showing blocked items to see the full list in that state


Portfolio-level Dashboard

At the Portfolio level, the Progress Dashboard consolidates progress across multiple Workspaces. Use it to track company-level objectives, see how each Workspace contributes to overall progress, and support leadership and executive reviews. For example, you can view this quarter's Objectives and see how each Workspace is contributing to their completion.

Portfolio dashboards work best when configured around Initiatives, Objectives, and Quarters. Workspace dashboards work best around Epics, Features, and Releases or Sprints.


Sharing the Dashboard

The Progress Dashboard is most valuable when it replaces the manual status report instead of supplementing it.

Instead of exporting a screenshot or spreadsheet for your next leadership sync, share the dashboard as a live link. Stakeholders without a Craft.io account can open it and see real-time data, not a snapshot from your last export.

Follow these steps:

  1. Open the Progress Dashboard

  2. Click Share

  3. Select LiveShare to generate a view-only link

The link stays active until you revoke it, so stakeholders always see the current state of the dashboard whenever they open it.


What comes next?

Need more guidance? 🙋 Our LIVE support team (bottom-right corner of your screen) replies to ANY question!

Did this answer your question?