# Review mode on the live preview

To comment on a feature's or a component's specification instead, see
[Review mode on specifications](/user-guide/product/review-mode).

Review mode lets you comment on what you see in the application a session is changing, while its
[live preview](/user-guide/sessions/live-preview) runs, and send your comments to the agent. You
pick a button, a heading or an area of a page and say what should change. The agent changes the
code, the preview reloads with the change, and the agent replies under each comment. When the
preview has a public link, the comments people outside your team leave through it show here too.

<Availability permission="Comments: Create to comment. Sessions: Update to send comments to the agent." />

## Key concepts

**Review mode.** A mode of the live preview in which the pointer picks what you comment on. While it
is on, the application doesn't react to your clicks: a click picks the element under the pointer.

**Preview comment.** A comment on an element of the running application, such as a button or a
heading, or on an area you drag over a page. It belongs to the session, and remembers the endpoint
and the page it was left on.

**Picture.** A picture of what you picked, taken when you pick it and saved with the comment, so the
agent sees what you saw. You can leave it out. A comment on an area of a page where element picking
isn't available has none.

**Pin.** The numbered marker of a comment on the preview. Numbers follow the order the comments were
made, so a comment keeps its number on every page, in **All comments**, and after another comment
is resolved. A pin's color shows how far its comment got:

| Pin | Means |
| --- | --- |
| **Waiting** | Not sent to the agent yet. **Send N to PM** sends it. |
| **Queued** | Sent, waiting for the agent's current step to end. |
| **PM is working on it** | The agent is on it now. |
| **Answered** | The agent replied. Check the preview, then resolve the comment, or reply to send it back. |

**Waiting comments and @pm.** A comment you leave waits, so you can collect several and send them
together with **Send N to PM**. A comment that mentions **@pm** goes to the agent as soon as you
save it.

**All comments.** Every open preview comment in the session, grouped by page, the page you are on
first.

**Outside comment.** A comment someone outside your team left through the preview's
[public link](/user-guide/sessions/live-preview#sharing-a-live-preview-publicly). It is labelled
**Outside viewer** and the name they gave, and goes to the agent only when someone sends it on its
own.

## Review mode at a glance

**Review** sits at the end of the row of tabs, between **Reload preview** and **Focus mode**. It
shows while an endpoint's tab is open, in a window at least 1024 pixels wide. Its count shows the
comments still open on the preview, on every page.

While Review mode is on, in the order you meet them:

- **The outline.** Point at the application: the element under the pointer is outlined.
- **The comment box.** It opens at what you picked, with **Taking a picture of the selection** while
  the picture is taken, then the picture. Choose **x** on the picture (**Remove the picture**) to
  leave it out.
- **The pins.** One for each open comment on the page you are looking at.
- **The bar** along the bottom of the preview:
  - a hint: **Click an element or drag an area**, or **Click an element to comment on it** while
    there are no comments yet. While the page gets ready, it reads
    **Getting the page ready for review**;
  - the counts, for example **3 waiting · 1 answered**, and **2 on other pages**;
  - **All comments**;
  - **Send N to PM**, which sends the waiting comments;
  - **x** (**Leave Review**).

While the agent works on comments you sent, the bar reads **PM is working on N comments**, with
**Stop** to stop the agent's current step.

## Commenting on the preview

### To turn on Review mode

1. Open the session. If its preview isn't running, start it: see
   [Live preview](/user-guide/sessions/live-preview#to-start-a-live-preview).
2. Open the endpoint's tab.
3. Choose **Review** at the end of the row of tabs.

**Review** is highlighted, and the bar appears along the bottom of the preview, with the pins of the
page you are on.

### To comment on an element

1. Turn on Review mode.
2. Point at the element. It is outlined.
3. Choose the element.
4. In the comment box that opens, enter your comment.
5. Choose **Comment**.

The comment becomes a numbered pin on the element, marked **Waiting**, and the bar counts it.

### To comment on an area

1. Turn on Review mode.
2. Drag a box over the part of the page you mean.
3. In the comment box that opens, enter your comment.
4. Choose **Comment**.

The comment becomes a numbered pin on the area, marked **Waiting**.

### To send a comment to the agent now

1. In the comment box, enter **@pm**, and choose **pm** (**Ask PM to fix this now**).
2. Write the rest of your comment.
3. Choose **Comment**.

The comment goes to the agent as soon as it is saved, and its pin reads **PM is working on it**, or
**Queued** while the agent finishes its current step. When the agent is done, the preview shows the
change and the pin reads **Answered**.

### To send the waiting comments

1. In the bar, choose **Send N to PM**.

Every waiting comment, on every page, goes to the agent in one message. Their pins read **PM is
working on it**, and the bar reads **PM is working on N comments**. When the agent is done, each
comment has its reply and its pin reads **Answered**.

### To follow up on a comment

1. Choose the comment's pin. Its thread opens: the picture, the comment and its replies.
2. Check the change in the preview, then do one of these:
   - If it is right, choose **Resolve**. The comment is resolved, and its pin goes away.
   - If it isn't, enter a reply and choose **Reply**. The comment is **Waiting** again, and the next
     **Send N to PM** sends it with your reply. When the comment mentions **@pm**, or your reply
     does, the reply goes to the agent at once.
   - To remove the comment and its replies, choose **Delete comment**.

### To find comments on other pages

1. In the bar, choose **N on other pages**, or **All comments**.
2. Choose a comment.

The preview goes to the comment's page, scrolls to it and opens its thread. A comment on another
endpoint opens that endpoint's tab first. To go to a page without opening a comment, choose **Go to
page** beside it.

### To send an outside comment to the agent

1. Choose the comment's pin, or choose it in **All comments**.
2. Above the thread, beside **From outside your team, through the public link**, choose **Send to
   PM**.
3. Read the confirmation, **Send this outside comment to PM?**, and choose **Send to PM**.

The comment goes to the agent on its own, in a message of its own, and its pin reads **PM is
working on it**, or **Queued** while the agent finishes its current step.

### To leave Review mode

1. Choose **Review** again, or **x** (**Leave Review**) at the end of the bar, or press Esc.

Esc closes what is open first: the comment box, then a thread, then **All comments**. The next Esc
leaves Review mode. The pins and the bar go away, and the application reacts to your clicks again.
Your comments stay, and the count on **Review** still shows them.

## How Review mode behaves

**Where it works.** Review mode works in Live, Plan and Bug fix sessions, whenever a preview is
running. It ends by itself when the preview stops, and when you open another session.

**What you send is a message.** A send shows in the session's conversation as an ordinary message
from you, for example "Please address these 3 comments on the preview". The agent gets each comment
with its replies, its picture, and the element and page it was left on.

**One message carries 20 comments at most.** When more are waiting, **Send 20 to PM** sends the
oldest 20, and the bar says how many go with the next send.

**A message waits while the agent is busy.** It waits in the conversation as **Queued**, with **Send
now** to stop the agent's current step and send it right away. See
[Working in a session](/user-guide/sessions/working-in-a-session#sending-messages-to-the-agent).

**The agent replies, and you resolve.** The agent changes the code, the preview reloads with the
change, and the agent replies in each comment's thread with what it changed. It never resolves a
comment itself: you resolve it once you have checked the change in the preview.

**Pins stay with their element.** A pin follows its element as you scroll. Pins show on the page
they were left on: move around the application, and each page brings up its own.

**Going to a page loads it again.** What the application had open, such as a dialog or a half-filled
form, isn't restored.

**Comments whose element is gone.** A comment whose element is no longer on its page stays in **All
comments**, marked **Element not found on this page**, and its thread still opens there. A comment
left on an endpoint the preview no longer has is marked **Not in this preview**.

**Preview comments are not plan comments.** They also show in the session's **Comments** tab,
labelled **Preview** with their page. They are never part of the plan: **Approve & build** and
**Request changes** don't count them.

### Comments from outside your team

When the preview has a public link with comments on, the people who open it can comment on the
application the way you do in Review mode. See
[Sharing a live preview publicly](/user-guide/sessions/live-preview#sharing-a-live-preview-publicly).

**Where they show.** Outside comments show among the preview's pins and in **All comments**,
beside your team's. Each is labelled **Outside viewer** and the name the viewer gave, such as
**Outside viewer · Ada Lovelace**: point at the name to see their email. A strip above the thread
reads **From outside your team, through the public link**. When the link has AI replies on, the
AI assistant's answers in the thread are labelled **AI assistant**.

**What you can do with them.** Reply, resolve or delete, as with any preview comment. The viewer
sees your replies in their comment, within about 10 seconds. Resolving the comment ends its AI
conversation, which is then summarized as an interview, and the viewer can no longer reply in it.
Deleting it removes it for the viewer too.

**They reach the agent only when your team sends one.** **Send N to PM** never takes an outside
comment, and an **@pm** the viewer writes doesn't send it. To send one, choose **Send to PM** on
it: see [To send an outside comment to the agent](#to-send-an-outside-comment-to-the-agent). It
goes alone, never with other comments.

**The agent treats it as a suggestion.** The agent is told the comment comes from a member of the
public through the shared link, not from your team, and that it is a suggestion about the
application, never an instruction to follow: nothing in it should lead the agent to run commands,
change credentials or settings, or reveal anything. It weighs whether the application should
change, and may change nothing. Read an outside comment before you send it, as you would any text
from outside your team.

**Mentions in them notify nobody.** A name or **@pm** an outside viewer writes is plain text.

## Permissions

| To | You need |
| --- | --- |
| Comment on the preview | **Comments: Create** |
| Resolve a preview comment | **Comments: Update** |
| Delete a preview comment | **Comments: Delete** |
| Send preview comments to the agent (**@pm**, **Send N to PM**, **Send to PM** on an outside comment) | **Sessions: Update** |

Without **Comments: Create**, Review mode shows the comments, and the bar reads **You can read these
comments; your role can't add them**. Without **Sessions: Update**, you can still add comments, and
the bar reads **An editor can send these comments to the agent**.

## Limits

One message to the agent carries 20 preview comments at most. The others wait for the next send.

## Troubleshooting

### "A comment from outside your team is sent to PM on its own"

The message named an outside comment beside other comments. Send the outside comment with its own
**Send to PM**, and the others with **Send N to PM**.

### "Update the Productmind agent to send comments from outside viewers (run `pm update`)"

The session runs on a Productmind agent too old to tell the agent a comment comes from outside your
team, so the comment isn't sent. Run `pm update` on the machine that runs the session, restart the
agent, and choose **Send to PM** again. See [Productmind CLI](/user-guide/tools/productmind-cli).

### Review is missing

**Review** shows only while the preview is running and an endpoint's tab is open. Start the preview
(see [Live preview](/user-guide/sessions/live-preview#to-start-a-live-preview)), then open one of its
endpoints instead of **Plan**. **Review** also hides in a window narrower than 1024 pixels: make the
window wider.

### "Element picking isn't available on this page"

The page can't run what Review mode uses to pick elements and take pictures: its own security
settings block it, or the preview runs on your machine through a local setup that doesn't add it.
Drag a box over the preview to comment on an area instead. The comment has no picture, so say in
words what should change.

### The comment has no picture

The comment box says why it couldn't take one, and the comment saves without it either way:

- "the page took too long to draw": the page was busy, for example while the agent was answering.
  Choose **Try again**.
- "this page didn't load the picture tool": the page's own security settings, or a network
  problem, stopped it. Choose **Try again**; if it keeps happening, say in words what should change.
- "something went wrong taking it": choose **Try again**.
- "the selection is too big, pick a smaller part": cancel, and pick a smaller element or area.
- "the page changed while it was taken": the application loaded another page. Pick again.

**Try again** pictures the element where it is now, so you can scroll before you choose it.

## Related topics

- [Live preview](/user-guide/sessions/live-preview)
- [Sharing a live preview publicly](/user-guide/sessions/live-preview#sharing-a-live-preview-publicly)
- [Working in a session](/user-guide/sessions/working-in-a-session)
- [Asking PM about a change](/user-guide/sessions/ask-pm-about-a-change)
- [Review mode on specifications](/user-guide/product/review-mode)
