# Review with comments > Drop pinned comment threads on the live Figma canvas in KopiMark, mention teammates, resolve threads, and keep notifications useful during copy review. _Source: https://kopimark.com/docs/guides/review-with-comments/_ Comments in KopiMark are how reviewers flag issues without leaving the canvas. They're **pinned to canvas coordinates** — not to a node — so you can comment on any part of the design, including the whitespace. The events log shows comments are by far the most-used collaboration surface in KopiMark. This guide makes sure you're getting the most out of them. ## Start a thread 1. In the editor, click the **comment tool** in the toolbar (or press the keyboard shortcut shown on the icon's tooltip). 2. Click anywhere on the canvas. A pin appears at that spot and a composer opens. 3. Type your message. You can format with markdown shortcuts (`**bold**`, `_italic_`). 4. Press **Comment** to post. The pin stays anchored — pan, zoom, or scroll, and it tracks the same spot on the design. > _[image placeholder: KopiMark editor with a pinned comment thread open on the canvas.]_ ## Mention a teammate Mentions are how you make sure someone actually sees a thread. They fire both an in-app bell notification and (by default) an email. 1. In the composer, type `@` followed by the start of the teammate's name. 2. A dropdown shows matching members. Click one, or use arrow keys and enter. 3. Post the comment. The mentioned person gets: - A bell badge in KopiMark (top-right of the header). - An email with a deep link to that thread (unless they've turned mention emails off in their profile). You can only mention people who are members or guests of the workspace. KopiMark doesn't fire mention emails to outsiders. ## Reply to a thread Click any existing pin (or use the **Comments** side panel — the speech bubble icon, top-right of the editor) to open the thread. Type in the reply box and post. Reply notifications are off by default to keep noise down. Each user can turn them on in [Notifications settings](/docs/settings/profile-settings/). ## Resolve a thread When a thread's done, click **Resolve**. The pin disappears from the canvas but the thread is preserved — open the Comments side panel to see resolved threads, reopen them, or filter them. Resolving a thread doesn't ping anyone. It's a cleanup action, not a publish action. ## The Comments side panel The speech-bubble icon in the editor toolbar opens a side list of every thread on the current page. From here you can: - Filter by **unresolved** / **resolved** / **mine** / **mentioning me**. - Click any thread to **jump to its pin** on the canvas. - See the **unread badge** — the same count shown in the header bell. Two patterns this enables that aren't obvious: - **Quick sweep before a sync** — open the panel, filter by *unresolved*, scroll. Faster than re-opening every pin. - **Audit a teammate's review** — filter by *mentioning me* to find every spot a reviewer flagged for your attention. ## Notifications, in brief Comments produce three kinds of notifications: - **Mention** — when someone `@`-mentions you. Bell + email by default. - **Reply** — when someone replies to a thread you've posted in. Bell only by default; email is opt-in. - **Assignment** — when someone assigns a status that has *you* as the assignee (statuses can carry an assignee — see [Statuses and approvals](/docs/guides/statuses-and-approvals/)). Bell + email by default. Email toggles live in your **Profile** under **Notification settings**. The bell is always on; you can't opt out of in-app notifications. ## What not to do - **Don't paste secrets** in comments. Comments are visible to anyone with project access. - **Don't use comments as a task tracker.** Statuses and assignments do that job better — comments are for the discussion, the status carries the state. ## See also - [Statuses and approvals](/docs/guides/statuses-and-approvals/) - [Notifications](/docs/settings/profile-settings/) - [How KopiMark works](/docs/concepts/how-kopimark-works/) --- ## All documentation _The full docs index, in case the answer lives on another page. Fetch any item as raw Markdown by appending `.md` to its URL, or grab everything at once from https://kopimark.com/llms-full.txt._ ### Start here - [Introduction](https://kopimark.com/docs/) - [Getting started](https://kopimark.com/docs/getting-started/) ### Concepts - [How KopiMark works](https://kopimark.com/docs/concepts/how-kopimark-works/) - [Figma sync and cache-only mode](https://kopimark.com/docs/concepts/figma-sync-and-cache/) - [Roles and workspaces](https://kopimark.com/docs/concepts/roles-and-workspaces/) ### Guides - [Connect Figma](https://kopimark.com/docs/guides/connect-figma/) - [If your Figma seat is limited](https://kopimark.com/docs/guides/figma-seat-and-rate-limits/) - [Invite your team](https://kopimark.com/docs/guides/invite-your-team/) - [Translate with AI](https://kopimark.com/docs/guides/translate-with-ai/) - [Review with comments](https://kopimark.com/docs/guides/review-with-comments/) _(this page)_ - [Statuses and approvals](https://kopimark.com/docs/guides/statuses-and-approvals/) - [Custom fonts](https://kopimark.com/docs/guides/custom-fonts/) - [Export copy](https://kopimark.com/docs/guides/export-copy/) - [API and developer tokens](https://kopimark.com/docs/guides/api-and-developer-tokens/) ### Settings - [A tour of Settings](https://kopimark.com/docs/settings/tour/) - [Profile settings](https://kopimark.com/docs/settings/profile-settings/) - [Workspace settings](https://kopimark.com/docs/settings/workspace-settings/) - [Project settings](https://kopimark.com/docs/settings/project-settings/) ### Reference - [Plans and limits](https://kopimark.com/docs/reference/plans-and-limits/) - [Keyboard and canvas](https://kopimark.com/docs/reference/keyboard-and-canvas/)