Link an epic from an agile board
Connect a project task to an epic on a Scrum or Kanban board so its progress updates on its own.
On this page
When part of a waterfall project is built by an agile team, you can link the project task to the epic that team is working on. That way the task's progress comes from the work finished in the epic, and you don't have to report it twice.
Before you start
You must be a Lead or Member of the project desk and of the agile board where the epic is.
Only tasks can be linked. You can't link phases, milestones or tasks that have subtasks (those calculate their progress from their rows).
You need the epic number, for example APP-42. You can see it in the backlog or on the agile board.
Steps
Go to the project and choose List.
On the task row, press Epic.
In Link epic, enter the number in Epic number (empty to unlink), for example
APP-42.Press Save.
If the number isn't shaped like an item number, you'll see "Enter an item number like APP-42.". If it doesn't match an epic on an agile board, the message says the epic doesn't exist.
How progress is calculated
The task's progress is taken from the epic like this:
If the epic is done, the task goes to 100%.
If not, it's the percentage of story points of the epic's items that are already done.
If the items have no points, it's the percentage of items done.
Subtasks on the agile board don't count. Progress updates on its own every time the work on the agile board changes.
What changes on the linked task
In the List, the Progress column shows the percentage and the epic number (for example,
45% · APP-42) and can no longer be edited.In the Edit form, Progress (%) disappears and it says "Progress comes from epic APP-42 (45%)."
The task's dates, duration and dependencies still belong to the project: the link only brings in the progress.
Change or remove the link
On the task row, press Epic. The form is called Change linked epic and shows the current number.
To link another epic, enter its number. To unlink, delete the number and leave the field empty.
Press Save.
When you unlink, the task keeps the last progress it got from the epic, and from then on you report it by hand again.