Skip to main content

Turn an epic back into a single task

Sometimes an epic turns out smaller than you thought: Analyze and Design show the work fits in one change. You can turn the epic back into a plain task at any point, even while it runs. One runner then does the whole piece of work and delivers it as one merged change.

Its subtasks don't come with it. Saving stops every subtask that is running and archives all of them: they leave the board but are not deleted. To keep the epic and only stop some of its subtasks instead, see Steer an epic's subtasks.

Who can do this: members with edit access to the epic's project. Only the epic itself can be changed, never one of its subtasks.

Decide before you change the setting. The task page saves your edits on its own every few seconds, so the change takes effect soon after you pick Task, even if you never select Save.

  1. Open the epic, and select its Task tab. Below the description, the first two settings read Epic and Guided or Unattended.

  2. Read the description again. One runner will do everything it says, so cut what you don't want in this one change.

  3. Open the first setting and pick Task. Its hover reads Task — one runner ships it as a merged PR.

  4. Read the line that appears under the settings: Saving stops this task’s subtasks and archives them. They leave the board but are not deleted.

    The epic's settings after picking Task: Task, Unattended, and the warning that saving stops and archives its subtasks

  5. Check the second setting. Picking Task can set it to Unattended; pick Guided if you want the runner to ask you before key decisions.

  6. Select Save. If the epic was running, the task is now stopped.

  7. To have the runner do the work, select ⋯ in the task's header, then Start.

  8. Check the board: the task's row has no ▸ any more, and its subtasks are gone from it.

Picking Epic again later does not bring the old subtasks back: the epic starts over from Analyze with new ones.