> ## Documentation Index
> Fetch the complete documentation index at: https://wonder.design/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Comments

> Pin comments on layers or anywhere on the canvas, reply in threads, mention people, attach files, resolve threads, find every comment in one list, and ask @Wonder or your agent to act on them.

Comments let your team discuss a design right where it is. Each comment starts a thread pinned to a layer or a spot on the canvas. This page covers leaving and answering comments, finding them, resolving them, and having @Wonder or your own agent act on them.

**Before you start** · Web and desktop · Free plan

Comments work the same in the browser and in the desktop app. Asking @Wonder needs the [desktop app](https://wonder.design/docs/desktop-app-and-browser.md).

## Who can comment

Every member of the file's workspace can read comments, start threads and reply, whatever their role. Viewers too, and on every plan. People who open a [public file](https://wonder.design/docs/share-a-file.md) from outside the workspace, and people who aren't signed in, don't see comments.

| You | What you can do |
| - | - |
| Any member | Start threads, reply, and edit or delete your own comments. Resolve, reopen and move the pins of threads you started. |
| Owner, admin or editor | Also resolve, reopen and move the pin of any thread, and ask @Wonder. |

See [Members and roles](https://wonder.design/docs/members-and-roles.md).

## Leave a comment

1. Choose the **Comment** tool in the toolbar, or press <kbd>C</kbd>.
2. Click where the comment belongs:
   * **A layer** pins the comment to the deepest layer under your pointer. Hold <kbd>⌥</kbd> while you click to pin it to the outermost layer, its frame, instead.
   * **Several layers.** <kbd>Shift</kbd>-click them, or drag a box around them. The comment goes on the nearest layer that holds them all.
   * **Empty canvas** pins the comment to that spot.
3. Write your comment in **Post comment…** and press <kbd>Enter</kbd>.

The bottom of the comment box shows where the comment will go: **On** and the layer's name, or **On canvas**. Press <kbd>Shift</kbd><kbd>Enter</kbd> for a new line, and <kbd>Esc</kbd> to cancel.

You can also right-click a layer or an empty spot and choose **Comment**.

In the [Preview](https://wonder.design/docs/preview-your-running-app.md), a click pins the comment to the element under your pointer, and the pin follows that element. Comments on elements of the Preview need the desktop app.

### Where pins go when the design changes

* A pin on a layer moves with the layer. You can drag it to another spot on the same layer.
* When the layer is deleted, its threads go away with it, and undoing the deletion brings them back. A pin on a layer inside a component instance moves to the instance instead.
* When an element in the Preview is removed from the code, its threads go away, and they come back if the element returns.
* Moving a page to trash keeps its comments.

When you zoom out, nearby pins group into one. Click the group to zoom in, or to choose a comment from a list when you can't zoom in further.

## Reply, mention and attach

Click a pin to open its thread. Write in **Reply…** and press <kbd>Enter</kbd>. Everyone in the file sees new comments and replies as they're posted, viewers included.

* **Mention someone.** Type <kbd>@</kbd>, or click **Mention someone**, and pick a member of the workspace.
* **Attach files.** Click **Attach files**, paste, or drag files onto the comment box. Any kind of file works, up to 25 MB each and 10 per comment. PNG, JPEG, GIF and WebP images show in the thread; other files are downloads. Attachments are only for people who can see the file's comments.
* **Edit or delete.** Open **Comment actions** on your own comment and choose **Edit comment** or **Delete comment**. An edited comment shows **Edited**. Deleting can't be undone, and when you delete the last comment in a thread, the thread goes too.
* **Copy a link.** Click **Copy link** at the top of the thread, or in **Comment actions**. The link opens the file on that page, with the thread open.

A comment can be up to 10,000 characters, with up to 50 mentions. Wonder doesn't email anyone about comments or mentions. Threads with comments you haven't read show under **Unread** in the comments list, and their pins are filled in.

## Resolve a thread

When the feedback is done, click **Resolve thread** at the top of the thread. Its pin disappears from the canvas. To bring a thread back, show resolved threads in the comments list, open it and click **Reopen thread**.

A thread can have up to 500 comments. A file can have up to 1,000 open threads; resolving one makes room for another.

## See every comment

Choosing the **Comment** tool turns the right sidebar into the **Comments** list, newest first. Each row shows who wrote the thread, when, the first comment and the number of replies. A comment on a Preview element also shows the element. A dot marks threads with comments you haven't read. Click a row to go to the thread, even on another page. Use <kbd>↑</kbd> and <kbd>↓</kbd> to move between rows.

* **All**, **Unread** and **Wonder** filter the list. **Unread** shows open threads with comments you haven't read, and **Wonder** the threads where someone asked @Wonder.
* The **Comment pages** button at the end of the filters chooses **This page** or **All pages**.
* **Search comments** (the magnifier) finds threads by their text and who wrote them.
* The **Comment options** menu shows resolved threads (**Show 3 resolved**, with your number), which also puts their pins back on the canvas, faded. It also has **Refresh comments**.

Press <kbd>⌘</kbd><kbd>.</kbd> to hide or show the sidebars. Click the **Comment** tool again to bring the list back.

Pins stay on the canvas when you switch to another tool, so you can open a thread at any time.

### Comment counts in Layers and Pages

The **Layers** list shows how many open threads each layer has. When a layer is inside a collapsed group, its count is added to the group. The **Pages** list shows how many open threads each page has. Resolved threads aren't counted.

## Ask @Wonder

Mention @Wonder in a comment to have Wonder make the change it describes. Type <kbd>@</kbd> and choose **Wonder**, "Edits the design on this comment", then post.

A new chat starts in your side panel with the comment as its request, in the [desktop app](https://wonder.design/docs/desktop-app-and-browser.md) of the person who asked. While it runs, the pin and the thread show its progress: **Wonder is working…**, and **Waiting for you in chat** with **Has a question** or **Needs approval** when it needs you. Answer it in the chat.

When it's done, Wonder replies in the thread with what it did and how many layers it changed. Click **Show changes** to see them. The person who asked can also click **Open in chat**, or **Stop** while it runs.

You can ask @Wonder when you're an owner, admin or editor and use the desktop app. Otherwise the mention list tells you why: **Ask Wonder from the Wonder desktop app**, **Update the Wonder desktop app to ask Wonder**, or **Only editors can ask Wonder**.

Editing a comment never starts @Wonder again. See [Wonder Chat](https://wonder.design/docs/wonder-chat.md) for working in the chat it starts.

## Let your agent read and reply

Agents connected over [Wonder MCP](https://wonder.design/docs/wonder-mcp.md), such as Claude Code, Codex and Cursor, can work through a file's comments for you. Ask, for example, "Go through the open comments on this page and fix them."

| Tool | What it lets your agent do |
| - | - |
| `list_comment_threads` | List a page's open threads, newest first, or every page's, and resolved ones too. |
| `get_comment_thread` | Read a thread's comments and attachments, and find the layer it's on. |
| `reply_to_comment_thread` | Reply in a thread. |
| `set_comment_thread_status` | Resolve or reopen a thread. |

An agent's reply shows as Wonder, with your name and the agent beside it, such as **Wonder via Claude Code** in the comments list. It can't be edited, but you can delete it. Agents reply when they've done the work and leave resolving to you, unless you ask them to resolve.

Agents can't start or delete threads, and they have your rights, never more. An access token that only reads a workspace can read comments but not reply or resolve. See [How it works](https://wonder.design/docs/wonder-mcp.md#how-it-works) for access tokens, and [Wonder MCP tools](https://wonder.design/docs/wonder-mcp-tools.md#comments).

## If something goes wrong

* **There's no Comment tool.** You're not a member of the file's workspace: you opened a public file from outside it. Ask someone in the workspace to [invite you](https://wonder.design/docs/share-a-file.md#invite-people-from-the-file).
* **You can't resolve a thread or move its pin.** Only the person who started the thread, or an owner, admin or editor, can. Pins on Preview elements, and resolved pins, don't move.
* **A comment disappeared.** Its layer, or its element in the code, was deleted. Undo the deletion, or bring the element back, to restore it. If someone deleted the comment itself, it's gone for good.
* **A link says "This comment thread is no longer available."** The thread was deleted, or its layer was.
* **@Wonder isn't in the mention list, or says why it can't run.** Use the desktop app, update it, or ask an owner or admin for the Editor role.
* **"Files must be 25 MB or smaller."** Attach a smaller file, or share a link to it instead.

## Related

* [Work together in real time](https://wonder.design/docs/work-together-in-real-time.md)
* [Share a file](https://wonder.design/docs/share-a-file.md)
* [Members and roles](https://wonder.design/docs/members-and-roles.md)
* [Wonder MCP tools](https://wonder.design/docs/wonder-mcp-tools.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.