Create issues

Create issues for a team, set properties, and link them to projects and cycles.

Create issues

Issues capture executable work on a team backlog.

Quick create

Open Issues for a team, a project, or My issues.

Press C or click New issue.

Enter a title (required).

Choose the team (pre-filled when opened from a team context).

Set Status, Assignee, Priority, and other properties as needed.

Optionally link a Project, Cycle, or Release.

Save. The issue appears on boards and lists for that team.

Create from a template

  1. Open the issue composer.
  2. Open the Template picker beside the team selector.
  3. Choose a standard or form template.
  4. Answer form questions if prompted; review pre-filled fields.
  5. Create.

Direct template links open the composer with the template preselected. See Issue templates.

Create sub-issues

Break large issues apart:

  1. Open a parent issue.
  2. Add a sub-issue from the sub-issue section or composer.
  3. Sub-issues inherit team context; track completion roll-up on the parent.

Sub-issue depth limits may apply when created from templates (see Templates).

Keyboard and command menu

  • C — new issue from most list pages
  • ⌘K / Ctrl+KNew issue or New issue from template…

Properties to set early

PropertyWhy set it
StatusPlaces the issue on the correct board column
AssigneeClarifies ownership
PriorityHelps ordering in triage and cycles
ProjectRolls work into portfolio reporting
EstimateFeeds cycle capacity when enabled
LabelsPowers filters and automation

Details: Issue properties.

Personal issues

Create an issue without a team for individual notes or tasks. Personal issues:

  • Do not use team estimates or cycles
  • Appear under My issues
  • Can be moved to a team later when work becomes shared

Expected result

A created issue should:

  • Appear on the team's issue list and board
  • Respect the team's workflow rules
  • Show in the project, cycle, or release you linked

Next

Last updated on