# Team Comments and Mentions Every team task has a comment thread, so discussion stays attached to the work instead of scattered across chat. See also: [[Managing Team Tasks]] and [[Team Notifications|Alerts]]. ## Comments ![[team-comments-mentions.png|415]] Open a task and add a comment in its thread. Comments support rich text, so you can format details, paste links, and keep context readable. - Comments are ordered in the thread on the task - When you open the Comments tab, a **New** divider sits above the comments you have not read yet, scrolled to the top of the feed. With nothing unread, the tab opens at the newest comment. Use **Mark as unread** on a comment to bring the divider back to it - Each comment shows the author's avatar and name - Discussion lives with the task, so anyone opening it later sees the full history ![[team-comments-new-divider.png|339]] - Paste a recording or attachment Copy-Link into a comment and it renders as an inline video player, the same as pasting one into a task description - Give a comment a one-click thumbs-up reaction when you agree or want to acknowledge it, without writing a full reply. Hover a reaction to see who reacted - Code blocks keep their syntax highlighting and line numbers once posted, and long lines scroll inside the block instead of stretching the comment panel > [!tip] Decisions where the work is > Keeping the conversation on the task means the "why" is right there when someone picks it up, with no digging through chat history. ## Files in comments and replies Select **Attach files** in the comment editor, choose your files, and post the comment. The files stay with the conversation and also appear in the task's **Details > Attachments** section, where each file is counted once. The same applies to replies. Removing a file from an unposted draft leaves it out of the task gallery. Deleting a posted comment removes its files and the files in its replies from the task's attachments. ![[team-comment-files.png|389]] ## Voice comments > [!note] Web app > Voice comments are available in the web app's Team Project task discussions. 1. Open a task's **Comments** tab and choose **Record voice comment**. 2. Allow microphone access when your browser asks. 3. Record your message, then finish the recording and post the comment. A recording can be up to **10 minutes** long. Posted voice comments have an audio player, so teammates can listen in the thread. A transcript appears when transcription is available and has finished processing. ## Unposted drafts If you start a comment and navigate away without posting it, Zaphiri keeps what you wrote. Come back to the task and it's still in the box. Find every unposted draft in the **Drafts** tab of [[Team Notifications|your notifications]], with a count on the bell. Pick up where you left off or discard it. Drafts are per browser, and posting the comment is what puts it on the task for everyone else. > [!tip] Half-written is still a signal > A draft you abandoned is often a decision you didn't finish making. The Drafts tab is a good place to check before a standup. ## @mentions Type `@` and a teammate's name to mention them in a comment. Mentioning someone notifies them. - The first matching teammate is selected automatically, so press **Enter** to insert that mention - Use the **Up** and **Down** arrow keys to choose a different match before pressing **Enter** - After a mention is inserted, its completed menu stays closed while you continue writing - The mentioned person gets a notification in their [[Team Notifications|inbox]] - Mentioning someone can also send them an email, as can commenting on a task assigned to them - Comments that mention you show a **Mentioned you** marker. Opening a linked comment briefly highlights that comment or reply - Mention anyone who's a member of the project > [!highlight] Mention to pull someone in > An @mention is the quickest way to get a specific teammate's eyes on a task. It lands in their notifications inbox, linked straight to the task. ## Threaded replies Reply to a comment to keep a sub-conversation together. Replies nest under the comment they answer, so a long thread stays organised instead of turning into a flat wall of messages. > [!success] Context that travels > Comments and mentions keep the discussion attached to the task. When work moves or someone new picks it up, the conversation comes with it. ## Share a comment in Slack Use the **Copy link** action on a comment's menu to grab a direct link. Pasted into [[Slack]], the link unfurls into a comment card showing the author and message, so you can point teammates to a specific decision without copying text around. Opening the link in Zaphiri jumps straight to that comment and highlights it. --- **Next:** See how mentions reach you in [[Team Notifications|Alerts]].