Skip to main content
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.

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 from outside the workspace, and people who aren’t signed in, don’t see comments. See Members and roles.

Leave a comment

  1. Choose the Comment tool in the toolbar, or press C.
  2. Click where the comment belongs:
    • A layer pins the comment to the deepest layer under your pointer. Hold ⌥ while you click to pin it to the outermost layer, its frame, instead.
    • Several layers. Shift-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 Enter.
The bottom of the comment box shows where the comment will go: On and the layer’s name, or On canvas. Press ShiftEnter for a new line, and Esc to cancel. You can also right-click a layer or an empty spot and choose Comment. In the Preview, 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 Enter. Everyone in the file sees new comments and replies as they’re posted, viewers included.
  • Mention someone. Type @, 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 ↑ and ↓ 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 ⌘. 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 @ 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 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 for working in the chat it starts.

Let your agent read and reply

Agents connected over Wonder MCP, 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.” 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 for access tokens, and Wonder MCP tools.

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