Track work with issues

Create issues and sub-issues in Tracker, set status, priority, labels and dates, and shape the list with views, filters and milestones.

Tracker holds your team's work as issues. Each issue belongs to a project and gets a short ID from it, such as TSK-12.

Create an issue

Open Tracker and select New issue, or press C.
Check the project at the top of the dialog, then type the Issue title. Add a description if you want one.
Set what you know: status, priority, Assignee, Labels, component, estimation, Milestone and Due date.
Select Create issue.

If you close the dialog before you create the issue, the button reads Resume draft and brings your entries back.

What an issue holds

Field	Notes
Status	A classic project has Backlog, Todo, In Progress, Done and Canceled.
Priority	No priority, Urgent, High, Medium or Low.
Assignee	One person per issue.
Labels	As many as you need. Manage them under Labels in the navigator.
Component, Milestone	Group issues inside a project. See below.
Start date, Due date	Both are optional.
Estimation and time	Set an estimation in hours. Press `T` on an issue to Add time report.

Open an issue to edit any field in the sidebar on its right, write the description, attach files and comment.

Sub-issues and relations

Sub-issues: right-click an issue and select Add sub-issue..., or use Set parent issue… on an existing issue. Sub-issues can have sub-issues of their own.
Relations: right-click an issue, select Relations, then Mark as blocked by..., Mark as blocking... or Reference another issue.... The issue then lists what it is blocked by, what it blocks and what it is related to. Relations inform people; they do not stop anyone from closing an issue.
From anywhere: New related issue in a right-click menu creates an issue linked to the item you clicked.

Find the issues you need

My issues has the tabs Assigned, Active, Backlog, Created and Subscribed.
All issues lists issues across projects. Each project under Your projects has its own Issues list. Both have the tabs All, Active and Backlog.
All projects lists the projects with their members.

Shape the list

The buttons above an issue list change how you see it.

Control	What it does
List and Board	The first two buttons switch between a list and a board of columns.
Grouping and ordering	The third button sets Grouping and Ordering, and has the switches Sub-issues, Show empty groups, Hide archived and Use colors.
Fields in each row	The fourth button picks the fields each row shows. Restore defaults puts them back. The third and fourth buttons both show the tip Customize view.
Filter	Narrows the list by a field: status, priority, assignee, labels, dates and more. With a filter on, select Save as to keep it as a filtered view; turn on Public if other people should see it. Saved views appear under Filtered views in the navigator.

Milestones, components and templates

Each project has three more pages under its name.

Milestones group issues toward a target date. A milestone is Planned, In progress, Completed or Canceled.
Components group issues by the part of the work they belong to.
Templates hold a ready-made issue, with sub-issues if you want them. In the New issue dialog, change No template to start from one.

Work from the keyboard

With an issue highlighted in a list: S then S sets the status, P then R the priority, A the assignee, L the labels and D the due date. Press X to select the highlighted issue, or Ctrl+A to select them all, then change them together. On macOS, use ⌘ where this page says Ctrl.

The full list is on Keyboard shortcuts.