Issue Templates

Reusable, pre-filled work items. Instead of retyping the same bug-report skeleton or the same acceptance-criteria checklist, define it once as a template and create work items from it in any project.

Plan: Pro and above

What you can do

  • Use six starter templates that ship with the product — no setup needed.
  • Create your own workspace templates with a name, description, a title template, a description template and a default priority.
  • Insert variables ({{date}}, {{project}}, {{workspace}}) that get filled in at the moment the work item is created.
  • Apply a template to any project in the workspace, optionally picking an assignee, and get a real work item back.
  • Delete templates you no longer want.

Getting started

Find the page

  1. Open Workspace settings.
  2. Click Issue Templates in the settings navigation.

You need to be a workspace Admin or Member to see it. Guests don't have access to workspace settings.

📷 Screenshot: Workspace settings → Issue Templates, showing the "Create Template" form and the template list below with the starter templates badged "Starter".

Use a starter template

Six predefined templates are available in every workspace out of the box, marked with a Starter badge:

TemplateFor
Bug ReportA reproducible defect — summary, steps to reproduce, expected vs actual, environment. Defaults to High priority.
Feature RequestA new capability — problem, proposed solution, acceptance criteria, alternatives. Medium priority.
TaskA general unit of work — objective, checklist, notes.
ImprovementEnhancing something that already exists — current behaviour, desired improvement, scope. Low priority.
Spike / ResearchA time-boxed investigation — question, time box, deliverable, findings. Medium priority.
IncidentA production incident — impact, timeline, root cause, follow-ups. Urgent priority.
  1. Find the template in the list and click Use.
  2. Pick the project to create the work item in.
  3. Optionally pick an assignee (the picker lists the members of the project you chose).
  4. Confirm. The work item is created in that project and the toast shows its number and title.

Starter templates can be used but not edited or deleted.

Create your own template

In the Create Template form at the top of the page:

  1. Name (required) — how the template appears in the list, e.g. "Customer escalation".
  2. Priority — the priority every work item made from this template starts with (None, Low, Medium, High, Urgent).
  3. Description — a note for your teammates about when to use this template.
  4. Title Template — the text that pre-fills the work item title, e.g. [Bug] . Leave a trailing space so people can type straight after the prefix.
  5. Description Template — the body the work item starts with. Headings, lists and checkboxes are supported.
  6. Click Create Template.

Your template appears in the list immediately, alongside the starters.

📷 Screenshot: The Create Template form filled in with a name, priority, title template and description template.

Variables

Three tokens are substituted when a template is applied:

TokenBecomes
{{date}}Today's date, e.g. 2026-07-13
{{project}}The name of the project the work item is created in
{{workspace}}The workspace slug

You can use them in the title template and the description template. A token with no available value is simply left as-is, so nothing breaks.

Example title template: [Incident] {{date}} — Example description line: Raised in {{project}} on {{date}}.

Deleting a template

Click Delete on any template you created and confirm. The work items already created from it are untouched — a template is a starting point, not a live link.

Tips

  • Put the boring, repeatable structure in the description template: the headings people always forget (steps to reproduce, acceptance criteria, rollback plan). That's where templates pay for themselves.
  • Prefix your title templates ([Bug] , [Spike] ) so filtered lists and searches stay readable.
  • Templates are workspace-wide, so one "Bug Report" template serves every project. You don't need a copy per project.

Limits & good to know

  • Templates are workspace-scoped — they are available in every project in the workspace, and there is no per-project template list in this page.
  • The form covers title, description and priority. It does not set a default state, labels or assignees on the template itself; you choose the assignee at the moment you apply it, and set state and labels on the work item afterwards.
  • There is no edit action on the settings page. To change a template, delete it and create a replacement.
  • Applying a template creates one work item. It does not create sub-items, a cycle, or a set of linked items.
  • A template is a snapshot, not a live template: changing it later does not change work items already created from it.