Skip to content
Toado Docs

Annotation toolbar

After a capture, the screenshot opens in the ticket detail view with an annotation toolbar above it. Annotations are saved as a separate overlay layer, so the underlying screenshot is preserved.

Tools

ToolShortcutWhat it does
Pan V Drag the image without drawing. Useful when you have zoomed in. Hold Space for a temporary pan from any other tool.
Pen P Freehand stroke. Drag to draw.
Highlighter H Translucent overlay. Useful for highlighting a column or region without blocking it.
Circle C Drag to draw an ellipse. Hold Shift for a perfect circle.
Arrow A Drag to draw an arrow. The head goes where you release.
Text T Click to place a text box, type, click outside to commit. Press T while the Text tool is already active to open the text-defaults editor.
Redact (solid block) R Drag a rectangle. The pixels under it become an opaque black box.
Blur B Like redact, but blurs instead of blacking out.
Eraser E Remove individual annotation shapes.
Undo Cmd + Z Undo the last annotation.
Redo Cmd + Shift + Z Redo.

Colors

A small preset palette, picked to be readable on the most common screenshot backgrounds:

  • Red, for “this is wrong”.
  • Yellow, for highlights.
  • Green, for “this is right”.
  • Blue, for general callouts.
  • Magenta, for the loud “look here” cases.

The colors are not configurable per-user in v1; we picked a small palette so annotations across teammates stay consistent. Switch the active color in the toolbar.

Redaction

Two flavors:

  • Redact draws an opaque black rectangle over the region. Use this for sensitive data you do not want anyone (including AI agents) to see.
  • Blur applies a Gaussian blur. Use when you want to hint at the structure of the redacted content without revealing it.

Both are destructive only at the rendered (annotated) layer. The original raw screenshot still exists in the system, and the unannotated screenshot URL (get_capture_asset(asset='screenshot')) returns the un-redacted bytes. If the data is truly sensitive, do not capture it in the first place. Use the pre-submit review flow to scrub before the capture leaves your machine.

Saving

Annotations save automatically as you draw. There is no Save button. The annotated overlay is reachable via:

  • In the UI, the rendered annotated image is what you see.
  • Via MCP, get_capture_asset(asset='screenshot_with_annotations') returns the rendered version. asset='screenshot' returns the raw, unannotated bytes.

For programmatic reasoning over what the user drew, prefer get_annotations, which returns the structured shapes (coordinates in image-pixel space).

Multiple images per ticket

You can drag-and-drop additional images onto a ticket (or use the file picker) to attach extras: a second screenshot, a design reference, a mobile-view comparison. Each attached image gets the same annotation toolbar.

Where to next