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

# Edit

> Repaint a region of an existing shot, or bring in elements from up to three reference images. Precision changes without regenerating the whole frame.

Edit changes one part of a shot without rebuilding the rest. Mask a region and rewrite it, or attach up to **three reference images** to bring in a character, prop, or style.

<Frame caption="Edit panel — masking tools on the canvas, references on the side">
  <img src="https://mintcdn.com/lettherebe/TUzvPsRco8soDYvV/images/image-mode/07-edit-entry.png?fit=max&auto=format&n=TUzvPsRco8soDYvV&q=85&s=503013cb9f9445339041e839150b0d28" alt="Edit panel entry view" width="1454" height="1688" data-path="images/image-mode/07-edit-entry.png" />
</Frame>

## When to reach for it

* One region of a shot is wrong — expression, pose, an object in the wrong hand
* You want to bring a character, prop, or style from a different image into this frame
* You need to add or remove a small element without losing the rest of the composition

## How to enter

The three edit modes (Edit, Upscale, Cinematic Shots) share two entry paths. Full flow is covered in [Create — image editing](/image-mode/create#refine-before-animating).

* **Path 1** — Click the pencil icon in the bottom-right of any beat gallery tile, then pick `Edit`.
* **Path 2** — Click `Edit` in the mode row above the bottom panel, then select a source tile.

## Two inputs you can combine

Edit accepts two kinds of input. Use either alone, or both together.

| Input                | What it does                                                             |
| -------------------- | ------------------------------------------------------------------------ |
| **Region mask**      | Paints the area to repaint. Pixels outside the mask stay untouched.      |
| **Reference images** | Up to three attached images — characters, props, or styles to draw from. |

The strongest results combine both. Mask the region, attach a reference, and write a prompt like "place the reference subject here, lit to match the scene".

## Region masking

The canvas exposes three tools. Pick what fits the shape of the change.

| Tool     | Behavior                                           |
| -------- | -------------------------------------------------- |
| `Pen`    | Free-form paint — soft brush over irregular shapes |
| `Eraser` | Removes mask strokes                               |
| `Crop`   | Locks a rectangular region                         |

Write the prompt below the canvas. The masked region regenerates to match the prompt while preserving the rest of the image.

<Frame caption="Pen mask on a region, prompt below describing the change">
  <img src="https://mintcdn.com/lettherebe/TUzvPsRco8soDYvV/images/image-mode/09-edit-inpaint.png?fit=max&auto=format&n=TUzvPsRco8soDYvV&q=85&s=d8bac24d12c5d463dac2864b6a4f7e64" alt="Region masking with pen tool" width="1420" height="1544" data-path="images/image-mode/09-edit-inpaint.png" />
</Frame>

## Reference images

Attach up to **three** images alongside the prompt. References can come from the beat gallery, from another asset, or from an external upload.

<Frame caption="Reference attachment slots — up to three images">
  <img src="https://mintcdn.com/lettherebe/TUzvPsRco8soDYvV/images/image-mode/08-edit-mention.png?fit=max&auto=format&n=TUzvPsRco8soDYvV&q=85&s=ce8ba35ba170cc58f68b7138e2365e1f" alt="Reference image attachment" width="1414" height="1544" data-path="images/image-mode/08-edit-mention.png" />
</Frame>

Inside the prompt itself, type `@` to mention a registered Character or Subject. The mention pulls in the canonical asset image without taking a reference slot.

## Camera and shot settings stay attached

Edit inherits the camera and shot panel from the source frame. The settings carry through so a repaint matches the original lens, depth, and framing.

| Panel      | Controls                           |
| ---------- | ---------------------------------- |
| **Camera** | Body, lens, focal length, aperture |
| **Shot**   | Shot size, angle, depth of field   |

Adjust them when the repaint needs a different lens character — for example, a tighter close-up inside a wide.

## Results land in the beat gallery

Edited frames flow back into the same **beat gallery** as the source. Promote with `↑`, archive with `↓` — identical sort to Create.

```
Source shot
   ↓ Edit (mask + optional references)
Repainted shot
   ↓
Beat gallery
   ├─ ↑ promote → shot gallery → video first frame
   └─ ↓ archive
```

## Choose the right tool

| Goal                                        | Tool                                           |
| ------------------------------------------- | ---------------------------------------------- |
| Change one region only                      | Region mask alone                              |
| Bring an element from another image         | Reference image alone                          |
| Composite a reference into a masked region  | Mask + reference together                      |
| Re-shoot the same beat at a different angle | [Cinematic Shots](/image-mode/cinematic-shots) |
| Push the same image to higher resolution    | [Upscale](/image-mode/upscale)                 |

## Next

<CardGroup cols={2}>
  <Card title="Cinematic Shots" icon="film" href="/image-mode/cinematic-shots">
    Nine alternative angles for the same beat.
  </Card>

  <Card title="Upscale" icon="maximize" href="/image-mode/upscale">
    Push the chosen shot to 4K before animating.
  </Card>
</CardGroup>