Skip to main content

Make a template that starts an epic

Some work your team repeats is too big for one runner: a dependency upgrade across the product, or a new report from requirements to release. Set the template's size to Epic, and every task started from it runs as an epic: Analyze, Design and Plan first, then one build subtask per planned item.

Who can do this: writing templates needs the Templates (org) feature on your plan and permission to edit templates, which Org Owners and Admins hold. On a plan without it, New template opens a Not on your plan page instead of the editor.

  1. Open Settings in the sidebar, then Templates under Customize, and select New template. The editor opens on its Task tab.
  2. Enter the Title, then write the brief in Description. An epic starts by pinning down the requirements, so say what the result should do, who it's for and what done looks like. Use {{input: Label}} for what changes each time, as in Ask for details when a template starts.
  3. Open the first setting under the description and pick Epic. Persona and Model leave Advanced: each stage of an epic picks its own.
  4. In the second setting, pick Unattended to let every stage decide for itself, or Guided to have Analyze and Design ask the person who started it before they settle the requirements and the design.
  5. Open the Library tab. Enter the Name, pick a Purpose and write a one-line Summary.
  6. Set Status to Published when it's ready, or leave it on Draft while you check it.
  7. Select Create.
  8. To check it, find it in the gallery and select Start. Under Start followed by the template's name, the first line of the dialog reads Epic · Unattended or Epic · Guided. Pick the Project and select Start, or close the dialog.

A template can't set Throttle, the number of subtasks that run at once. Set it on each epic after it starts, as in Limit how many subtasks run at once.