Skip to main content

Run an epic one stage at a time

Normally an epic runs straight through: each subtask starts as soon as the ones before it are done. When you want to check each stage before the next one builds on it, for example the requirements before the design, set its Throttle to Manual. Each subtask then waits as Held until you start it.

Who can do this: creating an epic needs permission to create tasks; starting it and its subtasks needs edit access to its project.

Start the epic held​

  1. In the sidebar, select the project, then select New Task on the board.

  2. Describe the outcome you want, then select Epic among the size buttons.

  3. Select Advanced. After Priority sits Throttle, shown for an epic only.

    Advanced open on a new epic: Priority, and Throttle set to Manual

  4. In Throttle, pick Manual, the last option. Each subtask then waits for Run, which here means the subtask's Start.

  5. Select Go. The epic is saved and started.

Step through the stages​

  1. Open the epic and select the Subtasks tab. The subtasks are grouped by stage, with Analyze first under Prepare.
  2. When a subtask's turn comes it shows Held. Select its title to open its page, open its ⋯ menu and select Start. It starts as soon as a runner is free.
  3. When it is done, open its Artifacts tab and read what it decided. If it went wrong, select Reset in its ⋯ menu, change its description on the Task tab, and start it again; see Steer an epic's subtasks.
  4. Go back to the epic's Subtasks tab and start the next Held subtask the same way, through Design, Plan, each build subtask and Finish.

Start never skips a stage: a subtask whose earlier stages aren't done shows Waiting and starts once they are.

Let it run on its own again​

To stop holding, open the epic's Task tab, select Advanced, set Throttle to No and save. From then on subtasks start on their own as the ones before them finish. A number instead lets that many run at once.