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

# The Review Room

> AI editors read your chapter and leave sentence-level comments, each with a suggested rewrite.

The **Review Room** gives your current chapter to a set of AI editors. They read it and leave **comments** in the margin. Each comment points at a specific sentence, explains the problem, and usually offers a rewrite you can apply in one click.

## Overview

Open the **Review** tab. You pick which editors read, run the review, and read their comments in the margin of your manuscript. Two tiles at the top track **open now** (comments still waiting on your call) and **selected** (how many reviewers will read on the next run).

<Frame caption="The Review Room. Reviewers are grouped into tiers. Turn them on or off, then run a review.">
  <img src="https://mintcdn.com/quarkle/pvbq7pupzmmMGYpd/images/app/review-room.jpg?fit=max&auto=format&n=pvbq7pupzmmMGYpd&q=85&s=c2acd167c559273a8311034adb137c10" alt="The Review Room showing reviewers grouped into tiers with comment counts" width="1568" height="721" data-path="images/app/review-room.jpg" />
</Frame>

## Run a review

<Steps>
  <Step title="Open the Review tab">
    You will see your reviewers, grouped into tiers.
  </Step>

  <Step title="Choose who reads">
    Reviewers are laid out as a ledger, grouped by tier. Tap a row to toggle it on or off. Each row shows how many open comments it has on this chapter and how many notes it's generated per day over the last 14 days.
  </Step>

  <Step title="Run it">
    Click **run review**. Comments stream in as each tier finishes. You can stop at any time. A toast tells you what the run left, for example *"3 comments added"* or *"Review done, nothing here needed a note."*
  </Step>
</Steps>

<Warning>
  A chapter needs at least **100 words**, and at least one reviewer on, to run a review.
</Warning>

## Review just a passage

Highlight a line or two you're unsure about, and the review button changes to **review N words**: it reviews only what's highlighted, not the whole chapter. Clear the selection and it goes back to **run review** for the full chapter.

<Frame caption="The review button reads the highlighted word count and scopes the run to it.">
  <img src="https://mintcdn.com/quarkle/pvbq7pupzmmMGYpd/images/app/review-word-count-button.jpg?fit=max&auto=format&n=pvbq7pupzmmMGYpd&q=85&s=2c5786c8b6ad2aea06d1d95c01171d04" alt="The Review Room panel's review button reading 'review 16 words' with a selection active" width="533" height="110" data-path="images/app/review-word-count-button.jpg" />
</Frame>

The bubble menu that appears over a selection has the same shortcut. Highlight text and click **Review this** to send just that passage.

<Frame caption="Highlight a passage and click Review this in the bubble menu.">
  <img src="https://mintcdn.com/quarkle/pvbq7pupzmmMGYpd/images/app/review-this-bubble-menu.jpg?fit=max&auto=format&n=pvbq7pupzmmMGYpd&q=85&s=9c1df41032f28ede0e9f7859669de6bf" alt="The bubble menu over a highlighted passage, showing Ask Quarkle, Review this, Expand, Embellish, Concise, and Restructure" width="979" height="153" data-path="images/app/review-this-bubble-menu.jpg" />
</Frame>

<Tip>
  Either way, your reviewers still read the whole chapter for context, judging whether a passage repeats a beat or earns its place needs the pages around it, they just leave comments only inside your selection.
</Tip>

## The reviewers and their tiers

Reviewers are grouped into four tiers, one per editing job:

* **Copy**: corrects errors, grammar, spelling, punctuation.
* **Line**: improves sentences, rhythm, clarity, word choice.
* **Developmental**: judges the story, structure, character, stakes.
* **Continuity**: checks details against the rest of the book.

You choose which reviewers are on. Working on character and not grammar right now? Turn the grammar reviewers off. Want an editor of your own design? See [Custom reviewers](/ai/custom-reviewers).

## Read a comment

Each comment attaches to a sentence and shows as a **bead** in the margin, coloured by tier. Click a bead to open the comment. The suggested rewrite previews right in the text as a diff, so you can see what would change before you decide.

<Frame caption="Click a bead to see the note and its rewrite, previewed inline as a diff.">
  <img src="https://mintcdn.com/quarkle/5WUUaYl-dgOEAFoM/images/app/review-comment-diff.png?fit=max&auto=format&n=5WUUaYl-dgOEAFoM&q=85&s=58eb79124037beb69708dec5303e9f6b" alt="A comment open in the manuscript, showing a suggested rewrite as an inline diff with accept and reject controls" width="944" height="384" data-path="images/app/review-comment-diff.png" />
</Frame>

## Apply or dismiss

* **Accept** applies the rewrite to your manuscript.
* **Reject** dismisses the comment and changes nothing.
* **Expand** opens the full note: the headline, the reason, and the rewrite.

Use **expand all** to preview every rewrite in the chapter at once, or **clear all** to dismiss them, both live in the panel header. Clear all only touches comments from reviewers currently switched on, so toggling a reviewer off first limits the damage. Nothing changes until you accept it.

## Comments from Chat

You do not have to run a full review to get comments. Ask [Quarkle Chat](/ai/quarkle-chat) to review, critique, or leave notes on the chapter, and it comments straight into the margin instead of replying in the thread. Those notes appear here in the Review Room too, tagged **Chat**, with their own on/off row in the ledger alongside the reviewer tiers.

<Tip>
  Curious how one "Run review" becomes a coordinated pass by many editors? See [Inside the Review Room](/under-the-hood/inside-the-review-room).
</Tip>

<Card title="Next: Custom reviewers" icon="arrow-right" horizontal href="/ai/custom-reviewers">
  Build an editor of your own.
</Card>
