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

# Editing a Rehearsal

> Edit a finished Rehearsal report: highlight what should change, add a note, and generate a new version. 

## What is the Edit function?

Once you run your Rehearsal, you can edit the report to best fit your needs. Edit mode allows you to make both structural and stylistic changes to the report.

Edits are a queue of comments, as if you were to comment on a Google Doc, and an agent will rewrite the report based on your feedback.

<Note>
  Editing changes how the report **reads**, not what the interviews **found**. The rewriter works from the same interviews and the same data. If you need different findings, you need a [new Rehearsal](/docs/platform/new-rehearsal).
</Note>

## What can you edit?

<CardGroup cols={2}>
  <Card title="You can edit" icon="check">
    * Any text in the **Overview**
    * Any text in the **Appendix**
    * **Charts** — click one to leave a note on it
    * **Tables** — click one to leave a note on it
  </Card>

  <Card title="You can't edit" icon="lock">
    * **Verification** — carried over unchanged
    * **Population** - linked to the simulation cohorts
    * **Interview transcripts** — the raw record of what replicas said
    * The **underlying findings** — the numbers come from the interviews
  </Card>
</CardGroup>

You can queue up to **20 edits** in one turn. If you have more than that, generate an edited report with your initial 20 edits, and then start a second round of edits.

<Info>
  Editing is available to admins and members of the organization that owns the report. People viewing a shared link can read the report but can't edit it.
</Info>

## How to edit a report, step by step

<Steps>
  <Step title="Open the report and press Edit">
    The Edit button lives in the upper right hand corner of the report, next to Share.

    <Frame>
      <img src="https://mintcdn.com/rehearsals/F-5AQPYWgJ6NioCx/images/where-edit-button-lives.png?fit=max&auto=format&n=F-5AQPYWgJ6NioCx&q=85&s=59540ffb4ac16926799620f812292314" alt="Where Edit Button Lives" width="1898" height="392" data-path="images/where-edit-button-lives.png" />
    </Frame>

    A short walkthrough of the three steps appears. Press **Start editing** to enter Edit mode. The report itself stays exactly where it was.

    <Frame>
      <img src="https://mintcdn.com/rehearsals/F-5AQPYWgJ6NioCx/images/Screenshot-2026-08-21-at-12.46.33.png?fit=max&auto=format&n=F-5AQPYWgJ6NioCx&q=85&s=991cb7fbbd89a790922dff9d170306a5" alt="Screenshot 2026 08 21 At 12 46 33" width="1076" height="910" data-path="images/Screenshot-2026-08-21-at-12.46.33.png" />
    </Frame>
  </Step>

  <Step title="Highlight what should change">
    Drag to select any passage of text, or click a chart or a table. Headings and pull quotes work too.

    Highlighted passages turn coral, and charts and tables show an outline when you hover over them.

    <Frame>
      <img src="https://mintcdn.com/rehearsals/F-5AQPYWgJ6NioCx/images/what-a-highlighted-passage-looks-like.png?fit=max&auto=format&n=F-5AQPYWgJ6NioCx&q=85&s=8f2ad34562ce745d5b0f00c578ccd16c" alt="What A Highlighted Passage Looks Like" width="1896" height="996" data-path="images/what-a-highlighted-passage-looks-like.png" />
    </Frame>
  </Step>

  <Step title="Say what should change">
    Your edit queue lives on the righthand side of the report. Like commenting on a highlighted section of the report, describe the change that you want, then press **Queue edit**.

    <Frame>
      <img src="https://mintcdn.com/rehearsals/F-5AQPYWgJ6NioCx/images/what-a-highlighted-passage-and-edited-comment-looks-like-1.png?fit=max&auto=format&n=F-5AQPYWgJ6NioCx&q=85&s=2e324faea5e08b488afe33c3dffb2a3a" alt="What A Highlighted Passage And Edited Comment Looks Like 1" width="3456" height="1176" data-path="images/what-a-highlighted-passage-and-edited-comment-looks-like-1.png" />
    </Frame>

    <Tip>
      Describe the outcome you want, not just the problem. "This is too vague" gives the rewriter less to work with than "say which cohort this came from and give the percentage."
    </Tip>
  </Step>

  <Step title="Review your queue">
    Every note you've added appears in the **Edit queue** next to the report, labeled with the section it points at, along with the passage you highlighted. From the queue you can jump back to that section, or press the **×** to remove an edit you've changed your mind about.

    <Frame>
      <img src="https://mintcdn.com/rehearsals/F-5AQPYWgJ6NioCx/images/what-edit-queue-looks-like-1.png?fit=max&auto=format&n=F-5AQPYWgJ6NioCx&q=85&s=8fb988cb9ebdef8eecbec7909c267c8c" alt="What Edit Queue Looks Like 1" width="758" height="1568" data-path="images/what-edit-queue-looks-like-1.png" />
    </Frame>

    <Warning>
      Queued edits aren't saved until you generate. Leaving Edit mode discards them.
    </Warning>
  </Step>

  <Step title="Press Generate New Report">
    The bar at the bottom of the screen tracks how many edits you have queued. Once you've made the suggested edits in the Edit queue, make sure to hit the **Generate New Report** button on the bottom right side. 

    <Frame>
      <img src="https://mintcdn.com/rehearsals/F-5AQPYWgJ6NioCx/images/Screenshot-2026-08-21-at-12.46.48.png?fit=max&auto=format&n=F-5AQPYWgJ6NioCx&q=85&s=44e180de4ee70e8e654a6508e16d8e8b" alt="Screenshot 2026 08 21 At 12 46 48" width="660" height="128" data-path="images/Screenshot-2026-08-21-at-12.46.48.png" />
    </Frame>

    Edit mode closes and a progress banner appears at the top of the report. The rewrite takes about 5 to 10 minutes, and the report refreshes on its own when it's done.

    Editing is iterative. Once the first pass of edits goes through, you can always continue to edit again with tweaks and changes.
  </Step>
</Steps>

<Note>
  Something not working the way you expect? Email [support@runrehearsals.com](mailto:support@runrehearsals.com).
</Note>
