Skip to main content
Skip table of contents

Working with Item Progress

Item Progress - Based on Percent Field Values

Getting Setup

The progress of items on your roadmap can be easily measured by assigning a percentage value to your item by using a Percent Field. You can learn more about creating a Percent Field here. Once you’ve created a Percent Field, you're ready to start visualizing the progress of your items on your roadmap.

Items Table View

Items table view

To set up or adjust the percentage values associated with your item in the Items Table View: 

  1. Navigate to the Items Table view on your roadmap

  2. Create or locate the Percent Field you’re looking to measure item progress by

  3. Add or adjust percentage values to this field, as necessary

Item Card

Item card

To set up or adjust the percentage values associated with your item in the Item Card:

  1. Navigate to your Timeline or Swimlane view

  2. Click on the item you’re looking to add a value to or adjust a value on

  3. Once clicked, the Item Card will open with the fields listed on the right-hand side

  4. Navigate to your intended Percent Field, or press + Field to create a new one

  5. Add or adjust the value and press the blue Update button to save these changes

Visualizing Item Progress

In order to visualize your Item Progress in your roadmap:

  1. Navigate to either the Timeline or Swimlane View

  2. Click on the Format icon in the toolbar to open the Format panel

  3. Scroll to the Item Progress dropdown in the Format Panel

  4. Select the Percent Field you want to use to visualize the progress of your items

  5. Once selected, the roadmap will update automatically to visualize the item progress

Timeline View

timeline view

Swimlane View

swimlane view

Item Progress - Based on Epic Progress

Through our native Jira Integration, Roadmunk users can pull the progress of their epics based on story completion and visualize that progress using the Item Progress feature in Roadmunk. Epic Progress can be calculated in one of two different ways:

Progress by Issue Count: Standard progress based on the count of completed stories in a given epic versus non-completed stories

Progress by Story Point: Weighted progress based on story point values assigned to completed stories in a given epic

Getting Setup

In order to pull the percentage values associated with your epics into Roadmunk:

  1. Navigate to any view on your roadmap

  2. Click the Integrate icon in the toolbar and select Setup Jira Integration/Modify Setup

  3. Navigate to the Dates & Fields tab in the Jira Integration window

  4. Under the Epic Progress to Sync section, select one or both "Progress by" options

  5. Save those details by pressing the blue Next/Update button

  6. Changes should be visible in the Items table view once the sync is completed

epic progress sync options

Visualizing Jira Epic Progress

In order to visualize your Item Progress in your roadmap:

  1. Navigate to either the Timeline or Swimlane View

  2. Click on the Format icon in the toolbar to open the Format panel

  3. Scroll to the Item Progress dropdown in the Format Panel

  4. Select the "Progress by" field you want to use to visualize Epic Progress

  5. Once selected, the roadmap will update automatically

Item Progress - Based on Progress of Work Items (For Azure DevOps)

Through our in-house Azure DevOps Integration, sync the progress of work items using the Item Progress feature. Progress can be calculated in the following ways:

Progress by Item Count: The percentage of completed versus uncompleted child items

Progress by Effort: The percentage of completed versus uncompleted child items weighted by Effort

Progress by Story Points: The percentage of completed versus uncompleted child items weighted by Story Points

Getting Setup

In order to pull the percentage values associated with your Azure DevOps information into Roadmunk:

  1. Navigate to any view on your roadmap

  2. Click the Integrations icon in the toolbar and select Setup Azure DevOps Integration/Modify Setup

  3. Navigate to the Select Fields tab in the Azure DevOps Integration window

  4. Under "Work Item Progress to Sync" section, select the desired Progress by option(s)

  5. Save those details by pressing the blue Next/Save button

  6. Changes should be visible in the Items table view once the sync is completed

image-20240514-192850.png

Visualizing Work Item Progress

In order to visualize your work item Progress in your roadmap:

  1. Navigate to either the Timeline or Swimlane View

  2. Click on the Format icon in the toolbar to open the Format panel

  3. Scroll to the Item Progress dropdown in the Format Panel

  4. Select the "Progress by" field you want to use to visualize progress

  5. Once selected, the roadmap will update automatically

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.