Skip to content
Track work

Issues

The unit of work in Runboard: status, priority, type, labels, assignee, sub-issues, links, comments, and activity — built so people and agents can both read and change it.

On this page

The issue model

An issue is one piece of work. Each one belongs to a project and takes its key from that project, like RUN-42. Beyond the title and description, an issue carries the properties that make it easy to scan, filter, and delegate:

  • Status — where the work sits in your workflow
  • Priority and Type — how urgent it is and what kind of work it is
  • Assignee — the person or agent responsible
  • Labels — cross-project tags for organizing and filtering
  • Due date, sub-issues, linked issues, comments, and an activity trail

Descriptions and comments are written in a rich editor and stored as Markdown, so they read cleanly whether a person or an agent wrote them.

Priority, type, and status

Priority

Five levels, ordered the way you triage: No priority, Urgent, High, Medium, Low.

Type

Three kinds of work: Task, Feature, and Bug.

Status

Statuses are defined per workspace and shared across every project. Each status belongs to one of five categories that drive grouping and open/closed behavior:

CategoryMeaning
BacklogCaptured but not yet scheduled
TodoScheduled, not started
In ProgressBeing worked on
DoneCompleted
CanceledClosed without completing

Add, rename, recolor, reorder, and set a default status under Settings — see Workspace settings.

Creating an issue

Press c anywhere, click New issue on the issues list or board, or use the command palette. A panel slides in to capture the work and set its properties: title, description, project, status, priority, type, assignee, labels, and due date.

Note

Status defaults to your workspace default, priority to No priority, and type to Task — so you can create an issue with just a title and fill in the rest later.

Editing an issue

Open any issue to edit it in place. The title is editable inline. The description is a full editor that auto-saves as you type, showing a saving indicator. In the right-hand Properties panel, status, priority, assignee, type, labels, and due date each save the moment you change them.

Issues are archived, not deleted — archiving hides an issue from lists and the board while keeping its history, and you can restore it later.

Sub-issues

Break a larger issue into sub-issues. The parent shows a progress bar and a done count, so you can see how much of the work is complete at a glance. Add a brand-new sub-issue or attach an existing issue as a child, and detach it when scope changes.

Comments and activity

Discuss work in the comment thread. Comments are Markdown, support emoji reactions, and appear in real time — including a typing indicator while someone is writing. Mention a teammate with @name to notify them.

The Activity timeline records every change — status moves, assignments, links, sub-issues, agent runs, and more — so the full story of an issue stays attached to it, no matter who or what made the change.

Custom properties

Add reusable typed fields that apply to every issue in the workspace — text, number, date, checkbox, or a single-select list. Use them for the dimensions your team tracks that aren't built in, like risk level or environment. Custom properties are searchable (see Views & search).

Improve this article

Spot something missing, outdated, or a broken link? Send the docs team a note.

Suggest an edit