Skip to content
TraceItX Docs
Documentation

Screenshot & annotate

A screenshot the reporter can draw on, with redaction applied before the image leaves the browser.

Updated

The reporter renders the current viewport in-browser — no screen-recording permission, no extension, no camera.

Annotation tools

ToolDraws
penFreehand. Five colours, three thicknesses.
highlighterTranslucent freehand.
rect · ellipseOutlined shapes for circling a control.
arrowPoints at the thing that broke.
textA label. Three sizes.
blurRedaction. Rendered opaque into the image — see below.
pointerSelect, move and resize existing marks.

The palette and sizes are identical across every TraceItX SDK, so a report looks the same whichever platform filed it.

Redaction is baked, not overlaid

A blur shape is rendered opaque into the image bytes before upload — not stored as a region for a viewer to honour. The pixels underneath are gone by the time the report leaves the browser.

That distinction matters. An overlay is a request; a bake is a guarantee. If a user blurs their bank balance, no receiver, no dashboard and no support engineer can recover it, because it was never uploaded.

The same applies to elements marked sensitive in code, which are masked before the screenshot is taken at all. See Sensitive content.

In the envelope

Two attachments can appear, and they are different things:

kindWhat it is
screenshotThe capture as taken.
annotated-screenshotThe baked result, with drawings and redactions applied.

Plus payload.annotations and payload.redactions, recording the vector shapes the user drew. A dashboard can re-render annotations over the clean screenshot, or offer a toggle — but only annotations. Redactions cannot be undone from the annotated image, by design.

Size

The screenshot is usually most of a report’s bytes. Typical sizes are in Errors & limits.

Canvas and cross-origin content

An image drawn from another origin without CORS headers taints the canvas, and a tainted canvas cannot be read. Those regions come back blank rather than failing the capture. Serve images with Access-Control-Allow-Origin if they matter to your bug reports.