--- url: /guides/comment-and-mention.md description: >- Discuss a task in its comments, bring a member in with an @mention, and point to another task with --- # Comment and mention people Comment on a task to keep the discussion next to the work, such as a question or a decision. Type `@` and a name to bring a member in — they get a [notification](/guides/set-up-notifications) — and `#` to point to another task. ## Before you start To comment, you need the list's **Comments** feature and **Read** access to the list ([Share a folder or a list](/guides/share-a-folder-or-list)). ::: warning Turn on Comments in the list If a task has no **Comments** tab, the list has **Comments** off. Turn it on in the list's **Configure** → **Features**; see [Set up a list](/guides/set-up-a-list#turn-features-on-or-off). ::: ## Comment on a task ::: warning Read access is enough You need **Read** access to the list and a [permission set](/reference/permissions-and-access) that allows comments; the **Worker** set does. You don't need **Edit** access to comment, react or mention someone in a comment. ::: 1. Open the task and select the **Comments** tab in the panel on the right. The task's comments show, with **Write a comment…** under them. 2. Click **Write a comment…**, or press C while the task is open (see [Keyboard shortcuts](/reference/keyboard-shortcuts)). The cursor moves into the editor under the comments. 3. Type your comment. The text appears in the editor. ::: tip Insert tables and checklists The editor is the same as in the [description](/guides/write-a-task-description): type `/` to insert a block such as a table or a checklist (see [Editor blocks](/reference/editor-blocks)). ::: ![The Comments tab of a task with three comments, one of them with a thumbs-up reaction, and the comment box holding a mention of Kate Lee and "can you check the screenshots?"](/shots/guides/comment-and-mention-1.light.webp){.light-only} ![The Comments tab of a task with three comments, one of them with a thumbs-up reaction, and the comment box holding a mention of Kate Lee and "can you check the screenshots?"](/shots/guides/comment-and-mention-1.dark.webp){.dark-only} 4. Optional: to attach files, drop them on the editor or click **Attach file**. The file appears in your comment. 5. Press Cmd/Ctrl+Enter or click **Send comment** (the arrow button under the box). The comment appears at the bottom and the task's [watchers](/guides/assign-and-watch-tasks) are notified. You now watch the task too, so you hear about the replies. ::: warning Comment or file not sent? "Failed to send the comment": check your connection and send it again. "Some attachments couldn’t be uploaded and weren’t sent": the comment went without them; click **Edit comment** on it and attach the file again. ::: ## Mention a member ::: warning Edit access for the description A mention in a comment needs only what commenting needs. A mention in the task's description needs **Edit** access, like any change to the description. ::: 1. In a comment or the task's description, type `@` and the first letters of a name. A list of people appears. ::: warning The person isn't in the list? You can mention only members who can open the task's list. [Share the list or its folder](/guides/share-a-folder-or-list) with them, then mention them again. ::: 2. Pick the person. Their name appears as a mention. 3. Send the comment. The mention appears in the sent comment. (In the description there is nothing to send: the mention saves as you type.) The person you mention: * sees "You were mentioned" in a pop-up, if they have [**Desktop pop-ups**](/guides/set-up-notifications#channels-where-notifications-reach-you) on; * gets a "… mentioned you in …" row in their [Inbox](/guides/set-up-notifications#inbox-where-notifications-wait) under **Mentions & replies**, with a line quoted from your text; * starts watching the task. If they turned off **Mentioned me** in their [notification settings](/guides/set-up-notifications#events-what-notifies-you), they only start watching the task. A mention of yourself sends you nothing; the comment still notifies the task's other watchers. For example, in the task **Prepare release notes** you send: ```text @Kate can you check the screenshots before Friday? The draft is in #Write the 2.4 changelog. ``` Kate is notified and starts watching the task; the changelog task becomes a clickable link. ## Link tasks with 1. Type `#` and part of the task's title or its [Task ID](/reference/task-ids). A list of tasks appears. 2. Pick the task. It appears as a link that opens it. 3. Send the comment. The task link appears in the sent comment. ::: info A # mention adds a relation Hule also adds a [relation](/concepts/relations) between the two tasks, of the type **mentions** / **is mentioned in**, and removes it when you remove the mention. For relations you add yourself, see [Link related tasks](/guides/link-related-tasks). ::: ## Edit, delete and react | Action | How | Who can | |---|---|---| | React | Click **Add reaction** on the comment and pick an emoji. | Anyone whose permission set allows reactions; the **Worker** set does | | Edit | Point at your comment and click **Edit comment**. The comment then shows "(edited)". | Only the author | | Delete | Point at your comment, click **Delete comment**, and confirm in **Delete this comment?**. | Only the author | On a touch screen, **Add reaction** stays on the comment; to edit or delete, tap **Comment actions** (⋯) first. ::: danger Deleting a comment can't be undone The comment is removed for everyone and can't be restored. ::: ::: warning Mentions added while editing notify nobody A mention you add while editing an existing comment doesn't notify anyone. To bring someone in, mention them in a new comment. ::: ## If it doesn't work * **There is no Comments tab.** The list has **Comments** off, or your permission set doesn't include reading comments. Ask the list's manager or an admin; see [Set up a list](/guides/set-up-a-list#turn-features-on-or-off) and [Permissions and access](/reference/permissions-and-access). * **The person doesn't appear after @.** They can't open the task's list. [Share the list or its folder](/guides/share-a-folder-or-list) with them, then mention them again. * **"Failed to send the comment".** Check your connection and send it again. * **"Some attachments couldn’t be uploaded and weren’t sent".** The comment was sent without them. Click **Edit comment** on it and attach the file again. * **"The attachment couldn’t be uploaded. Remove it or try again."** Nothing was sent. Remove the file from the editor or drop it again, then send. * **Someone you mentioned wasn't notified.** You added the mention while editing a comment, or they turned off **Mentioned me** in [Set up notifications](/guides/set-up-notifications#events-what-notifies-you). Mention them in a new comment, or ask them to turn **Mentioned me** on. ## Related * [Assign and watch tasks](/guides/assign-and-watch-tasks) — who follows a task and why. * [See what changed in a task](/guides/see-task-history) — changes and comments in one timeline. * [Set up notifications](/guides/set-up-notifications) — where mentions reach you. * [Task relations and the relations graph](/concepts/relations) — what the **mentions** relation is and where it shows. * [Permissions and access](/reference/permissions-and-access) — which permission sets can read and write comments. * [Keyboard shortcuts](/reference/keyboard-shortcuts) — C puts the cursor in the comment box. * [Link related tasks](/guides/link-related-tasks) — relations you add yourself. * [Editor blocks and shortcuts](/reference/editor-blocks) — what you can insert with `/`. * [Set up a list](/guides/set-up-a-list) — turn on **Comments** for a list.