Docs Demo Dashboard Get your key
On this page
  1. Leaving a comment
  2. The picture of the page
  3. The thread
  4. Attaching images
  5. Improve
  6. Moving a pin
  7. The side panel

Comments and pins

A comment is pinned to the element it is about, not to a spot on the screen, so it stays on that button or heading when the layout changes. It works the same in the extension and on a site with the script.

Leaving a comment

  1. Press Comment in the toolbar, or Alt+C (⌥C on a Mac).
  2. Move over the page. The element under the pointer is outlined and named, so you can see what the comment will be pinned to.
  3. Click it, write, and send it with the button in the box, or Ctrl+Enter (⌘↵ on a Mac).

A guest is asked for a name the first time; see Layers and people. Esc, or Alt+C again, stops without leaving one. What you typed is kept for the tab if the box closes by accident.

Menus, tooltips and hover states can be commented on. While you place a comment the page does not hear your clicks, so an open menu stays open, and moving the pointer still opens things that open on hover.

The picture of the page

Each comment keeps a picture of what its writer was looking at, with the element outlined and the pin on it. Anyone reading the comment later can open it, which is what keeps “this button is misaligned” making sense after the page has changed. On a site with the script, the developer can turn pictures off; see data-snapshots.

The thread

A comment thread: the comment with reactions, a reply, and the reply box.
A comment, its reactions and a reply.

Clicking a pin opens its thread. In it you can:

A thread's window, and the box for a new comment, can be dragged by the dots at its top left when it is in the way. The pin stays where it is.

Attaching images

A comment or a reply can carry up to four images: a mockup of what is wanted, a screenshot from another device, a photo of a printout. Paste one into the box, drop it onto the box, or pick it with the image button under the box. Anyone who can write a comment can attach images, guests included, and the author can take images out or add new ones when editing.

Improve

Under the comment and reply boxes, Improve rewrites what you typed so it reads clearly, keeping what you meant and the people you mentioned. Undo brings your own words back. It is part of the Pro plan, and your own plan decides, whoever's layer it is. It is not shown to guests.

Moving a pin

The author of a comment can drag its pin onto a different element. Where it is dropped is pinned exactly as the first placement was, outline and all. For everybody else a pin only opens its thread. Esc during the drag puts it back, and so does Undo on the confirmation. How pins find their element again after the page changes is under How pins anchor.

The side panel

The side panel button in the toolbar, or Alt+P, opens every comment on the layer as a list, newest first, with replies folded under each. Where the window has room it opens beside the page, which moves over to make space; otherwise it opens over it.