docs/cloud/issues.mdx
Issues are the individual work items in your project - bugs to fix, features to build, tasks to complete. Each issue lives on your kanban board and can be assigned to team members, tagged, prioritised, and tracked through your workflow.
<Frame> </Frame>An issue represents a single piece of work. It has:
TASK-123 for easy referenceTo create an issue in a specific column:
To create an issue using the header button:
<Frame> </Frame> <Steps> <Step title="Open the create panel"> Click the **+** button in the header next to the status tabs. </Step> <Step title="Enter the title"> Type a clear, descriptive title. The title field is focused automatically. </Step> <Step title="Set the status"> Choose which column the issue should start in. </Step> <Step title="Set priority (optional)"> Select a priority level (default is no priority):| Priority | When to Use |
|---|---|
| Urgent | Needs immediate attention, blocking other work |
| High | Important, should be done soon |
| Medium | Normal priority |
| Low | Nice to have, can wait |
If you want to immediately start working on an issue with AI assistance:
<Frame> </Frame>See Workspaces to learn more about working with coding agents.
Click any issue card on the board to open the issue panel. The panel slides in from the right side.
Changes to the title and description save automatically as you type. You don't need to click a save button - just edit and your changes are saved.
<Info> Auto-save has a small delay (about half a second) to avoid saving every keystroke. If you close the panel immediately after typing, wait a moment for the save to complete. </Info>Properties like status, priority, assignees, and tags save immediately when you change them:
| Property | How to Edit |
|---|---|
| Status | Click the status dropdown and select a new status, or drag the card to another column |
| Priority | Click the priority dropdown and select a level |
| Assignees | Click the assignees field, select/deselect team members |
| Tags | Click the tags field, select/deselect tags |
The description uses a rich text editor with formatting options:
The issue panel has collapsible sections for additional information:
Shows development workspaces linked to this issue. Workspaces are where coding agents do their work.
<Frame> </Frame>Each linked workspace shows:
To link a workspace:
Click the + button in the Workspaces section header to create a new workspace or link an existing one.
<Frame> </Frame>To unlink a workspace:
Click the ⋯ menu on the workspace and select Unlink from issue.
<Frame> </Frame>Issues can have child issues (subtasks) for breaking down work:
<Frame> </Frame>Discussion thread for the issue:
Break large issues into smaller, manageable pieces using sub-issues.
When viewing a sub-issue, you'll see a Parent link below the issue properties. Click it to navigate to the parent issue.
<Frame> </Frame>Issue Actions provide quick access to common operations on an issue. You can access them in two ways:
Click the More button (three dots) in the top-right corner of the issue panel.
<Frame> </Frame>Open the command bar with Cmd/Ctrl + K, then select Issue Actions.
| Action | Shortcut | Description |
|---|---|---|
| Create Issue | I C | Create a new issue |
| Change Status | I S | Move issue to a different status |
| Change Priority | I P | Set or change priority level |
| Change Assignees | I A | Add or remove assignees |
| Make Sub-issue of | I M | Make this issue a child of another |
| Add Sub-issue | I B | Add a sub-issue to this issue |
| Link Workspace | I W | Connect a workspace to this issue |
| Duplicate Issue | I D | Create a copy of this issue |
| Delete Issue | - | Permanently delete this issue |
To share an issue with someone:
Share this link with team members - they can click it to go directly to that issue.
You can select multiple issues to perform bulk operations, similar to how you'd select files in a file manager.
| Method | Action |
|---|---|
| Checkbox | Hover over the left edge of a list row to reveal its checkbox, then click |
| Cmd/Ctrl + Click | Toggle an individual issue in or out of the selection |
| Shift + Click | Select a range of issues between the last selected issue and the clicked issue |
| X | Toggle the currently open issue in or out of the selection |
| Shift + J / Shift + ↓ | Extend the selection downward by one issue |
| Shift + K / Shift + ↑ | Extend the selection upward by one issue |
| Cmd/Ctrl + A | Select all visible issues |
| Escape | Clear the selection |
When two or more issues are selected, a floating action bar appears at the bottom of the screen. From this bar you can:
| Action | Description |
|---|---|
| Status | Change the status of all selected issues at once |
| Priority | Set the same priority across all selected issues |
| Assignee | Assign or change assignees for all selected issues |
| Delete | Permanently delete all selected issues |
Click the X button on the action bar or press Escape to clear the selection.
<Warning> Bulk delete is permanent and cannot be undone. All selected issues, their comments, and their history will be removed. </Warning> <Tip> Use filters to narrow down your view before selecting issues. For example, filter by a specific status, then press **Cmd/Ctrl + A** to select all matching issues for a bulk status change. </Tip>To delete a single issue:
To delete multiple issues, select them and click Delete in the bulk action bar.
<Warning> Deleting an issue is permanent. The issue, its comments, and its history are removed. Sub-issues are not deleted - they become standalone issues. </Warning>Every issue has a Simple ID - a short, unique identifier like TASK-123. This makes it easy to reference issues in conversations, commits, and documentation.
The Simple ID is shown: