Comments

Comments attach to a place in your site rather than to a document. You click a spot in the preview, leave a note, and it shows as a pin there for everyone in the workspace.

Before you begin

Commenting is for people in the workspace that owns the project. Someone opening a public link cannot comment, and the speech bubble does not appear for them. Only workspace members can be mentioned.

Leave a comment

1. Click the speech bubble in the floating toolbar at the bottom of the preview. The left panel switches from chat to Comments.
2. Click the spot on the page you want to talk about.
3. Type into the box that opens. The placeholder reads Add your comment...
4. Press Add, or Cancel to drop it.

A comment can be up to 1000 characters. Cmd or Ctrl with Enter submits from the keyboard, and Escape closes the box.

The comment becomes a pin carrying your avatar, positioned against the element you clicked, so it follows that element as the page reflows. Pins for comments that scrolled out of view collect into a small stack at the top or bottom edge of the frame, showing up to three avatars and a count, labelled above or below. Click one to scroll to it.

Write with mentions, emoji and AI

Three controls sit under the input.

The smiley opens an emoji picker that appends to what you have written.

The @ button, or typing @, opens the list of workspace members. Picking someone inserts a mention, and they get an email about it. Only accepted members of the workspace are notified.

The wand rewrites what you have written into cleaner phrasing. It needs at least five characters before it turns on.

Read and reply

Click a pin, or a row in the Comments panel, to open the thread. Its header says Comment.

The reply box at the bottom is placeholded Reply and posts with the Reply button. Replies are listed under the original with their own author, time and menu.

Under the first message is a reaction row. The smiley there offers six reactions: like, love, wow, applause, angry and sad. You hold one reaction at a time, and picking the one you already gave removes it.

Editing a message adds a small (edited) after it.

Sort the list

The Comments panel header has a dropdown with Newest, All and Resolved. Newest and All both show every thread, most recent first. Resolved narrows the list to the ones marked complete.

With no comments yet, the panel invites you to give feedback, ask a question or leave a note of appreciation, and to click anywhere to leave one.

Resolve, edit and delete

The round checkbox on a row in the list marks the thread complete. Completed threads fade in the list, lose their pin on the page, and the thread itself shows Marked as completed. Unchecking brings it back.

The three dots menu on a comment holds:

• Copy Link, which puts a link to that comment on your clipboard
• Mark as completed or Mark as uncompleted, from inside the thread
• Edit and Delete, on your own comments only

Deleting is immediate. The thread leaves the panel and its pin leaves the page for everyone.

From an AI client over MCP

list_comments, get_comment and count_open_comments read what reviewers have asked for, and list_comment_attachments reads the screenshots they attached. create_comment, reply_to_comment, update_comment, resolve_comment, reopen_comment and delete_comment write back, alongside move_comment_pin, the two reaction tools and the two attachment tools.

Reading needs comments:read, ticked by default. Writing needs comments:write, which is not. A client can only edit or delete comments it wrote itself, the same rule the product applies, and an @ mention left by a client does not send a notification email.

See MCP tools.

Next

• Use the preview is where the pins live.
• Select an element is the tool to use when you want AI to make the change instead.