Skip to content

Selector Annotations

Add visual markers to your screenshots before capture: borders, highlights, and hidden elements, by CSS selector.

Selector annotations or AI annotations

ScreenshotAgent has two kinds of annotations. The ones on this page are selector annotations: borders, highlights and hidden elements that you point at with a CSS selector. They are applied in the browser before the capture, so they are exact, and they do not use any allowance.

AI annotations mark the captured image instead, drawing on top of it without changing its pixels. Use them for marks a CSS outline can’t draw (a hand-drawn circle, an arrow, a numbered callout) or to blur data you can’t target with a selector. They come from your plan’s monthly AI annotation allowance.

Selector annotationsAI annotations
How you targetCSS selectorPlain language, like "the Approve button", or a CSS selector
MarksBorder, highlight, hideCircle, arrow, highlight, callout, blur, browser frame
When appliedIn the browser, before each captureOn top of the image, after each capture (with a rule)
Capture pixelsThe page is styled before captureNever changed outside the mark
CostFreeOne AI annotation per screenshot; free with a CSS selector

Overview

Annotations modify the page’s appearance before the screenshot is taken. They are rendered directly in the browser, so they appear in the captured image at full fidelity.

Border annotations

Draw a colored border around one or more elements. Useful for highlighting specific UI components in documentation.

PropertyDescription
SelectorCSS selector for the target element(s)
ColorBorder color (hex, e.g., #FF0000)
WidthBorder width in pixels

Highlight annotations

Overlay a semi-transparent color on elements. Useful for drawing attention to a specific area of the page.

PropertyDescription
SelectorCSS selector for the target element(s)
ColorOverlay color (hex)
OpacityTransparency level (0 to 1)

Hiding elements

Hide distracting or irrelevant elements like cookie banners, chat widgets, or notification bars. Hidden elements are set to visibility: hidden, preserving the page layout while removing visual clutter.

Common elements to hide
.cookie-banner
#intercom-container
.notification-bar
[data-testid="chat-widget"]

Tip

Use hiding to create clean documentation screenshots without temporary UI elements that would confuse readers.