# Comments

Source: https://modulify.ai/docs/editor/comments

Pin feedback to a spot on the page and discuss it in a thread.

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](/docs/mcp/tools).
## Next

- [Use the preview](/docs/editor/preview) is where the pins live.
- [Select an element](/docs/editor/select-element) is the tool to use when you want AI to make the change instead.