How to use @mentions in Linear
Learn how to use @mentions in Linear: type @ in an issue comment, pick an issue from the menu, and post the comment to reference it for your team.
Quick answer
Open an issue, click the comment box, and type @ to open the mention menu. Linear lists Users and Issues. Choose the item you want, such as an issue like ARC-4 Set up your teams, and it appears in the comment as a chip. Select Submit comment to post it.
Steps at a glance
- Open the issue you want to comment on.
- Click the comment box at the bottom.
- Type @ to open the mention menu.
- Pick an issue from the Issues list.
- Select Submit comment to post it.
Interactive demo
Summary
Mentions let you point to another issue or a person from inside a comment. Typing @ opens a menu so you can pick the right item without leaving the issue, which keeps related work connected.
Step-by-step guide
Step 1
Open an issue
From the Active tab of your team's issue list, click the issue you want to comment on, such as Import your data. The issue opens with its description and the Activity section below it.
Step 2
Click the comment box
Scroll to the bottom of the issue and click the comment field that reads Leave a comment…. The cursor moves into the box and the Submit comment button sits next to it.
Step 3
Type @ to start a mention
Type @ in the Comment box. A menu opens above the box so you can choose who or what to mention.
Step 4
Pick an issue to mention
The menu groups results under Users and Issues. Under Issues, click ARC-4 Set up your teams. The mention replaces the @ in your comment as a chip showing the issue ID and title.
Step 5
Send the comment
Select Submit comment to post it. The mentioned issue is now referenced in the Activity section of the issue you commented on.
Why this matters
You are discussing ARC-3 and realize another issue affects it. Mentioning that issue in your comment puts a reference right in the conversation, so teammates reading the thread can jump to the related work instead of searching for it.
Frequently asked questions
What can I mention in a comment?
Typing @ opens a menu with a Users section and an Issues section, so you can mention a person or reference another issue.
Does the mention appear as plain text?
No. After you pick an item, it appears in the comment box as a chip that shows the issue ID and title, for example ARC-4 Set up your teams.
Related guides
Continue with more step-by-step guides for getting work done.
How to add comments to issues in LinearLearn how to add a comment to a Linear issue: open the issue, click the comment box under Activity, write your note, and post it with Submit comment.
How to create issue relations in LinearLink two Linear issues so the dependency is visible: open an issue, use Mark as, choose Blocked by, and pick the issue that blocks it.
How to add attachments to issues in LinearLearn how to attach files, images, videos and links to a Linear issue, so your team has the supporting material next to the work in one place.
Create interactive demos like this one — free, no coding required.
Start for free →