Skip to content →

Reference issues

Add inline references to Linear issues

Linear app showing a related issue in the sidebar

Overview

Reference Linear issues in issue descriptions as well as comments on issues. Referencing them inline will also create a related issue in Linear. If you don't remember the issue ID, you can search for the issue from a small search box that appears when you start creating the reference.

Cmd/Ctrl . to Copy issue ID then paste or type the issue ID into the editor. Use Space after to turn it into a hyperlink or Enter to keep it plaintext.

@ then Issue ID , title or issue prefix to search and reference an issue in descriptions and comments.

M then R to mark as related (created automatically when you reference inline)

Cmd/Ctrl Shift , to copy the issue URL

Cmd/Ctrl . to copy the issue ID

See Issue Relations to set blocking, blocked, and other relations

Basics

Reference issues

While in a description or comment, type Issue ID then Space to reference an issue in descriptions and comments. You can also use the shortcut Cmd/Ctrl . to copy the ID. It will create a hyperlink to the issue that when hovered shows you the referenced issue's title and assignee. Typing the Issue ID then Enter will leave it as plaintext.

Referencing an issue will automatically create a relation to the referenced issue, which will show up in the issue details sidebar.

Inline search to reference

If you don't know the exact ID, type @ or followed by the issue ID to launch an inline search in the text editor. Continue typing the issue number or a word in the title to find the issue, then press enter. This will add the hyperlinked issue ID inside of the description or comment.

Reference without linking

To reference an issue without creating a relation, you can copy and paste or type the issue ID in the description then press Enter instead of Space.

Issue links

You can get an issue link from any issue with the shortcut Cmd/Ctrl Shift , and the issue ID with Cmd/Ctrl .

When sharing links with others, you can remove everything after the ID in the URL to create a shorter link. https://linear.app/<workspace_name>/issue/<issue_ID> goes to the same place as https://linear.app/<workspace_name>/issue/<issue_ID>/<issue_title>. If an issue's issue ID has changed (e.g. after moving it to a new team), any old links will redirect to the new one.

Special relations

If you'd like to indicate a special relation, such as blocked, blocking, or duplicate, set the relation first, then link to the issue in a comment or description. Issues can only have one type of relation with another issue, so referencing an issue that already has a relation will not create an additional related flag.