Skip to content
Documentation

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.

Open as Markdown Full docs bundle

Open this page in

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.

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.

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). 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

Start typing to search the docs.