Comments and @Mentions

Every OverlayQA issue has a threaded comment section where your team can discuss findings, ask questions, and coordinate fixes. Comments support @mentions to notify specific teammates and sync in real time across all open tabs.

Add a Comment

Open any issue in the sidebar or dashboard to see its comment thread. Type your message in the "Add a comment" field at the bottom, then press Enter or click Send to post. Comments appear instantly with optimistic UI; if the network request fails, a retry button appears below the comment.

@Mentions

Type @ followed by a teammate's name to mention them. A dropdown appears above the input showing matching team members with their avatars. Use Arrow Up and Arrow Down to navigate the dropdown, Enter to select the highlighted member, and Escape to dismiss it. Mentioned teammates receive a notification, and mentions render as blue chips in the thread so they stand out visually.

Edit and Delete

Hover over your own comment to reveal the menu (three dots). Click Edit to modify the text or Delete to remove it. Edited comments show an "(edited)" indicator.

Real-Time Updates

Comments sync in real time using server-sent events (SSE). When a teammate posts, edits, or deletes a comment on the same issue, you see the change immediately without refreshing. If the connection drops, it reconnects automatically and fetches any missed comments.

Figma Comment Sync

When Figma is connected, comments from Figma are merged into the same thread. Figma-origin comments display a purple "Figma" badge so you can tell where each comment came from.

Integration Sync

Comments also sync with connected integrations. Jira, Linear, Notion, Asana, and Trello sync comments back to the OverlayQA issue, and Slack thread replies appear as comments. This keeps the conversation in one place regardless of where your team prefers to work.