Create issues

Creating issues is the most common action taken in Linear.

Overview

Issues are always linked to a single team. They have an issue ID (team's issue identifier and unique number) and are required to have a title and a status—all other properties and relations are optional.

Create an issue

Use the keyboard shortcut C to open up an issue creation modal
Use V to create an issue in full screen mode.
Click the Create new issue icon in the upper left of the app.
To create an issue from a template use Option/Alt C, or hold Option/Alt and click the Create new issue icon.
Enter https://linear.new into your browser URL bar to create new a issue. It will redirect you to the new issue creation page as long as you are logged into your Linear account.
Issues can be created using our GraphQL API. Many integrations in our directory allow creating issues from other services using this functionality.

If you have text highlighted when you go to create an issue, this will pre-fill in the issue title. Email attachments are limited to 25 MB.

Create an issue via email

Issues can be created by sending or forwarding an email to a unique email address associated with a Linear team or a Team-level template.

A link to the original email will be included as an attachment on the Linear issue. The original sender will not be emailed back from Linear when the issue is updated or resolved.

Creating an issue from email uses the same formatting types as regular Linear issues, and can display attachments like images inline.

Create an email address

To create a email address for a team, navigate to Settings > Teams > General > Create by email and enable the toggle.

Create a email address for a template

To create an email addresses for a team template:

Navigate to Settings > Team > Templates
Click the three dots on the right of the template.
Select Configure email address.
Enable the toggle in the pop-up.
Click Continue.

When a team template is used, the issue's title and description will be overwritten by the email contents, but the properties of the template will be applied to the new issue.

Consider creating a rule in your email client to forward certain emails to Linear.

Create an issue from a URL

Issue URLs allow users to create a new issue by navigating to the URL, supported by pre-filled fields and properties.

Create a new issue URL

The following links trigger the creation of a new Linear issue in any browser and you can add query parameters after any of them to pre-fill issue fields.

To pre-fill issue fields and/or properties:

Add a ? at the end of the link.
Include the field or issue property you want to pre-set.
Add =.
Add the parameter you are setting.
Use & between each field or issue property when creating a string of pre-settings.

Apply pre-set properties

We support the following query parameters:

title and description:

Use + to indicate empty space in the keyword.
For example, https://linear.new?title=My+issue+title&description=This+is+my+issue+description

status

Can be set by UUID or name of the workflow status
For example, https://linear.new?status=Todo

Priority

Can be set by Medium, Urgent, Medium or Low
For example: https://linear.new?priority=urgent

assignee

Can be set by UUID or display name/name of the user
For example, https://linear.new?assignee=john or https://linear.new?assignee=Erin+Baker

estimate

Can be set by their point number e.g. estimate=4
T-shirt sizes have the following point values: No priority (0), XS (1), S(2), M (3), L (5), XL (8), XXL (13), XXXL (21)
For example, https://linear.app/team/LIN/new?estimate=2

cycle

Can be set by UUID, cycle number of a name of a cycle
For example, https://linear.app/team/MOB?cycle=36 or https://linear.new/team/EU/new?cycle=focus+on+bugs

label

Use a comma between each label you want to apply
For example, https://linear.new/team/LIN/new?label=bug or https://linear.new?labels=bug,android,comments

project

Can be set by UUID or the name of the project
For example, https://linear.new/team/LIN/new?project=Project+page+improvements

milestone (a project must be defined)

Can be set by UUID or the name of the project milestone
Project milestone can be read only if project is also passed in the URL
For example, https://linear.app/team/LIN/new?project=Project+page+improvements&projectMilestone=Beta

Create a URL from a template

Go to Settings > Team > Templates.
Click the three dots to the right of the template.
Select Copy URL to create issue from template.

Copy a URL from an issue

While on an issue's view, or an issue is highlighted or selected, open command bar by typing Cmd/Ctrl + K and select Copy pre-filled create issue URL to clipboard.

Drafts

When writing an issue and navigating away to another part of the app, Linear will hide the issue modal and keep a temporary draft. The next time you go to create an issue, the editor will re-open with the previous content draft. This type of draft is saved locally and only available on the client used to create it. Logging out, restarting, or resetting Linear will clear this type of draft.

If you use Esc or click on the close button, a pop-up modal will appear giving you the option to save the issue as a draft. This draft type persists across clients and will not clear on logout or reset. To access your saved drafts, re-open the create issue modal and click Drafts in the upper right to see the list of drafts available.

FAQ

Security & Access

Edit issues