Every status in Craft.io carries a completion percentage. It determines how much an item in that status contributes to its parent's progress, and it powers progress everywhere it is displayed, including the Progress Dashboard.
A Feature in Dev in Progress is further along than one still in Spec Needed.
Assigning a percentage to each status lets your progress calculations reflect that difference, instead of treating all unfinished work the same.
Before you begin
You will need:
Admin access to Workspace or Portfolio Settings
Your statuses and status categories already configured. See Configuring your workflow and statuses if you have not set these up yet.
How progress rolls up
Progress rolls up the hierarchy, from Stories to Features, Epics, and Initiatives.
A parent item's progress is derived from the percentage of its child items' statuses.
For example, an Epic with 2 Features in a status set to 100% and 1 Feature in a status set to 50% shows 83% completion.
Each item contributes its status's percentage. If Dev in Progress is set to 50%, a Feature in that status contributes 50% toward its parent Epic's progress.
This applies whether your Progress Dashboard calculates by item count or by a numeric field like story points. In both cases, the status percentage is the input.
To choose a calculation method, see Using the Progress Dashboard.
Setting a percentage for each status
By default, every status in the Open and In Progress categories is set to 0%, and every status in the Done and Closed categories is set to 100%. You can change any of them to match how your team actually works. Nothing here is permanent - you can adjust a percentage at any time.
Follow these steps:
Open Workspace Settings and, under Statuses, select Workflow & statuses.
In a Portfolio, open Portfolio Settings and select Initiative StatusesFind the Calculated progress column, next to your status names
Click a percentage to edit it
For example, you could set "In Design" to 20%, "Ready for Dev" to 25%, and "Dev in Progress" to 50%.
A status in the Done category can also be worth less than 100%. For example, you could set "Dev done" to 95% while deployment is still pending.
A percentage must stay between the values of the statuses immediately before and after it. If you enter a value outside that range, Craft.io snaps it to the nearest boundary and shows a note: "Progress updated to stay between the previous and next status values."
The final status in your last category - the one that marks work as fully done - always stays at 100% and cannot be edited.
Reordering and adding statuses
Dragging a status to a new position keeps its percentage if it still fits between its new neighbors. If it does not, Craft.io adjusts it to the nearest neighboring value, with the same note shown above.
When you add a new status, it inherits the percentage of the status directly before it in that category. You can adjust it from there.
What comes next?
Configuring your workflow and statuses - set up your statuses and categories if you have not already
Using the Progress Dashboard - choose how progress is calculated and see how these percentages roll up across your Workspace or Portfolio
Need more guidance? đ Our LIVE support team (at the bottom right corner of your screen) replies to ANY question!