Create issues

Overview

Every Issue belongs to one Team and receives an Issue key when created. A title and status are required; the Team supplies the initial status.

You need permission to create work in the selected Team. An enabled public Team may offer Submit issue for review to people outside the Team. That form sends a title and description to Triage.

Creating issues

Select New issue in the top right of your Team's Issues page, or use the workspace sidebar's create action. Choose a Team and enter a title of up to 200 characters.

Add a description and any properties you need, such as an assignee, priority, labels, estimate, due date, or Project. Creating from a Project's Issues tab starts with that Project selected. Use the expand control if you need more room for the description.

Select Create issue, or press Ctrl + Enter on Windows or ⌘ + Enter on macOS. The success message shows the new Issue key. Enable Create more to keep adding Issues without closing the dialog.

The … menu groups relationships first: Set parent…, Add sub-issue…, and Add relation. Choose Set parent… to place the new Issue beneath an existing Issue in the same Team. Use Add relation → Blocked by…, Blocks…, or Related to… to select an existing Issue and describe the connection. Review or remove the selected relationships in the dialog before creating.

To prepare sub-issues alongside the parent, choose … → Add sub-issue…. Finish or cancel the open child editor before submitting the parent. If a child fails after the parent is created, Retry sub-issues completes the remaining drafts without recreating the parent.

Creation supports an initial parent or an initial relation, not both together. Add further relationships from the Issue after creating it. Recurring Issues do not offer a parent or initial relation.

Create an issue via email (coming soon)

Integrity does not yet turn incoming email into Issues. Create an Issue in the app and add the relevant context instead.

Team intake email (coming soon)

Team email intake addresses are not available.

Templated intake email (coming soon)

Template-specific email addresses are not available.

Create recurring issues

Use a recurring schedule for work such as a weekly review. You need the Team's permission to manage recurring Issues.

Open Create issue for the Team and fill in the work to repeat. Choose … → Make recurring, set the first due date and repeat schedule, then create it.

The first Issue is created with the schedule. Later occurrences become eligible after their scheduled due date passes in the Team's timezone. Edit the schedule to change future work; existing Issues keep their own details. Issue templates are (coming soon), so enter the recurring Issue's details directly.

Convert an existing issue into a recurring issue (coming soon)

Direct conversion is not available. Create a recurring schedule with the details you want future Issues to use.

Create recurring issues from team settings

Open Team settings → Recurring issues to create and manage schedules. See Create and edit a schedule.

Create a new issue URL (coming soon)

Shareable links that open a prefilled creation form are not available.

Apply pre-set properties (coming soon)

Set properties in the create dialog instead of adding them to a URL.

Create a URL from a template (coming soon)

Template creation links are not available.

Copy a URL from an issue (coming soon)

Prefilled creation links are not available. Copy URL on an existing Issue links to that Issue; it does not create a copy.

Drafts

Your work stays in the open create dialog while you edit. A saved Drafts library that survives closing the dialog or switching devices is (coming soon). Create the Issue before leaving if you need to keep it.

FAQ