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

# Annotate

> Draw on an image, save your markup, or generate an image or video from your drawing and instructions.

Annotate opens an image in a full-screen drawing editor: circle what needs to change, scribble a camera move, paste in a reference, write a note to your team. Saving creates an **annotation** image right beside the original, so the markup travels with the project instead of living in a screenshot tool.

Find **Annotate** on any ready image: on its toolbar, in its right-click menu, and in the asset menus in [File View](https://docs.preview.io/preview/preview-window.md) and the [Player](https://docs.preview.io/preview/player.md). Images only, and you need edit access.

If you see **This annotation is unavailable**, choose **Close** to leave that session. Your other open drawings and tabs stay open.

## The tools

* **Brush** (B) and **Eraser** (E): freehand drawing; the eraser removes just the part of a stroke you cross. Adjust size with the slider or **\[** / **]**; each tool remembers its own size.
* **Text** (T): click and type. A bar above the text sets its color, font (**Regular**, **Bookish**, **Typewriter**, or **Handwritten**), size, and alignment, for the selected text or the next text you place. Turn on **Highlight** in the color menu to put a tinted box in the text's color behind the whole text. **Bold**, **Italic**, **Underline** and the list menu (**Bullets**, **Numbered**, or **Checklist**; **None** removes the list) format the characters you've selected while typing, or all of each selected text. While typing, ⌘B, ⌘I and ⌘U work too. The size menu has **Small** (16 px), **Medium** (24 px), **Large** (32 px) and **Extra large** (48 px), and a field for an exact size from 6 to 240 px: type a number, click **−** / **+**, or drag across it. Drag the pill on the text's right edge, or the one that shows when you point at its left edge, to set where it wraps, and the dot at its corner to scale it. Click a checklist box to check or uncheck it without selecting the text.
* **Line** (L) and **Arrow** (A): lines can be straight or curved, and arrows take an Arc or Elbow path and a choice of arrowheads.
* **Shapes**: rectangle (R), ellipse (O), triangle (⇧T).
* **Select** (V) and **Hand** (H) have keys but no toolbar button: V goes back to selecting and moving marks, H drags the view around.
* **Image layers**: **Add image** to upload, browse Files, or **Click to pick** from the canvas (or just paste or drop an image); the arrange menu reorders layers.
* **The image you opened is a layer too**, on a white frame the size of the original. When you start a new annotation on one image, its layer is already selected and **Image properties** is open. You can move, resize, crop, flip, rotate, replace, or delete it like an added image. Saving keeps the frame's size, with white wherever the image doesn't reach. The eraser never removes it.
* **Change the frame's shape**: the aspect menu beside the zoom control, bottom right (it reads **Original** at first), offers the common ratios, with your project's marked **Project**. The frame grows around your image, which keeps its size: a square photo at 16:9 gets white on both sides, and at 9:16 white above and below, ready to fill by generating. **Original** returns to the image's own size. If a smaller frame would cut off part of what shows, Annotate asks first. A **Draw** surface keeps its long edge. One undo reverses the change, and a saved annotation reopens with its frame.
* **Fit to frame**, the first icon in the **Image** section when the image you opened is selected, puts it back at the frame: centered, as large as fits without stretching, with crop, flips, rotation, and opacity reset. One undo reverses it.
* **Snapping**: while you drag or resize a mark, its edges and center snap to the frame's edges and center, with no key to hold.
* **Transform an image**: select it, and the **Image properties** panel's **Transform** row has **Crop**, **Flip horizontal**, **Flip vertical**, and **Rotate 90° clockwise**. **Remove background**, the right icon in the **Image** section, cuts the image out; like the other [one-click transforms](https://docs.preview.io/preview/quick-actions.md#one-click-transforms), it's free.
* **Crop an image**: select it and click **Crop** in the **Transform** row, then drag the handles, or drag the image to move it inside the frame. The toolbar under the image has a zoom slider and an **Aspect ratio** menu with **Custom**, **16:9**, **9:16**, **1:1**, **2:3**, and **3:2**. To apply the crop, click **Crop** on that toolbar, click **Finish crop** in the panel, or press Enter. **Cancel crop** (the X) or Esc undoes the whole crop session. Cropping changes only the layer, not the image file.
* **Replace an image**: select one image, then click **Replace image** in the **Image** section above **Transform**. Hover over an image action to see its name. Choose **Upload image** for a local file or **Browse files** for one project image. The layer keeps its frame, center, rotation, opacity, flips, and stacking order. The replacement fits without stretching; a different aspect ratio can leave transparent space inside the frame. Existing crops keep their center and circular mask, with the crop window adjusted to fit the replacement. Other layers using the old image stay unchanged. Cancel or a failed load leaves the original in place; undo and redo restore the whole replacement. Replacement is unavailable during cropping, saving, or that layer's background removal, and never applies to multiple selected layers or to the fixed background of an annotation saved before images became layers.
* The **properties panel** sets color, size, stroke style (solid, dashed, dotted, or drawn), fill, and opacity for what you draw next, or for what's selected. Text is styled from its own bar; for selected text the panel offers only the arrange controls. **Undo / redo** (⌘Z / ⌘⇧Z or ⌘Y) and **Clear all** cover the session. **Esc** drops the current tool, then closes.

A stylus switches to pen mode automatically, with a control in the header to bring finger input back.

## Keyboard shortcuts

**Keyboard shortcuts** in the **More** menu (**⋯**, top right) or **?** lists these inside Annotate. They are also in the [Help panel](https://docs.preview.io/preview/settings-menu.md)'s shortcut list.

| Action | Shortcut |
| - | - |
| Select | V |
| Hand | H |
| Brush | B |
| Eraser | E |
| Text | T |
| Rectangle | R |
| Ellipse | O |
| Triangle | ⇧T |
| Line | L |
| Arrow | A |
| Smaller size | \[ |
| Larger size | ] |
| Undo | ⌘Z |
| Redo | ⌘⇧Z |
| Previous image | ↑ |
| Next image | ↓ |
| Cancel tool, then close | Esc |

When you open an image, the arrow keys don't move it, and ↑ and ↓ switch images in the results strip. Click the photo or select another mark to nudge it with the arrow keys instead.

## Generate from your drawing

With an image open in Annotate, draw the change or movement you want, then describe it in the prompt box. Choose **Image mode** or **Video mode**, select a model and settings, and generate. For video, you can also add start and end frames or references supported by the model.

Your drawing and written instructions guide the generation together. Video generation starts directly from those inputs; you don't need to generate an edited image first.

The original image counts toward the video's reference capacity. Reference audio can also reduce how many frames or image references fit, depending on the model. If Annotate cannot read an externally hosted reference video, upload the clip to Preview and attach the uploaded file instead.

Results appear in the thumbnail strip on the left, with progress for each variation and a retry option for failures. Select a finished video to play it in the main viewing area. Select **Original** to return to your drawing and prompt; generating doesn't replace them.

**Open file**, beside the name at the top left, opens the selected image or video in its own tab, or switches to its tab if it's already open. Annotate stays open with your drawings, prompt, and results.

Closing Annotate lets submitted generations continue. You can find completed results in Files.

Once you change the frame's shape, or move, resize, crop, flip, rotate, fade, replace, or delete the image you opened, Generate sends the whole frame as a layout: the model keeps the image where you placed it and fills the white space from your prompt and drawing. Undo back to the image as it opened, or choose **Original** and use **Fit to frame**, and Generate works as before. Putting the crop back over the whole image does too: choose **Custom** in **Aspect ratio**, or return the zoom slider to 1×. A circular crop still sends the layout, even when it covers the whole image. A replaced or background-removed image stays a layout even after **Fit to frame**. The result comes back at the selected model's nearest aspect ratio and resolution to the frame, shown in the prompt box (**Closest to frame**); Save keeps the frame's exact size.

Video keeps working while the image you opened is unchanged, or only moved or resized on its frame. With a moved or resized image, the video takes the frame's shape at the model's nearest aspect ratio, chosen for you when you pick a model (your own choice comes back once the image is back as it opened), and the model fills the rest of the frame from your prompt and drawing; where the image ends up is approximate. This works with every video model in Annotate except MiniMax H3, which shows **This drawing isn't supported in video yet. Try image mode.** Video becomes unavailable when a crop hides part of the image, when the crop is circular, or when you flip, rotate, fade, replace, or delete the image. If Video was already selected when you make such a change, it stays selected but can't generate until you switch to **Image mode** or undo the change; your prompt and video settings are kept. Starting with a blank **Draw** surface supports image generation only. So does a saved annotation whose strokes can't be restored, for example because its original image was deleted: it opens as a flat image.

## Saving

**Save** (top right, beside **Discard**) adds the annotated image beside the original; the original is untouched. Open an annotation in Annotate again and your strokes are still editable, not flattened. Replaced images remain editable too, and earlier saved revisions keep their original images. Local replacements are stored when you save without adding a separate file to Files; browsing reuses the project image.

In [Provenance](https://docs.preview.io/preview/preview-window.md), an annotation's inputs are the images in it. A cutout shows **Remove background** and the image it was cut from. If you cut out the image you opened, it shows through its cutout, not as a separate input. A file generated from the annotation keeps that whole history.

> [!TIP]
>
> Annotations are ordinary images: assign them to shots, reference them with `@`, or comment on them like anything else. Mark up a storyboard frame with arrows and the agent can read your intent from the annotation when you reference it.

> [!NOTE]
>
> Annotate replaced Inpaint on the toolbar. You can also use **Enter changes...** on the file's toolbar to describe an edit, or reference the image in a prompt.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.