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 annotations | AI annotations | |
|---|---|---|
| How you target | CSS selector | Plain language, like "the Approve button", or a CSS selector |
| Marks | Border, highlight, hide | Circle, arrow, highlight, callout, blur, browser frame |
| When applied | In the browser, before each capture | On top of the image, after each capture (with a rule) |
| Capture pixels | The page is styled before capture | Never changed outside the mark |
| Cost | Free | One 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.
| Property | Description |
|---|---|
| Selector | CSS selector for the target element(s) |
| Color | Border color (hex, e.g., #FF0000) |
| Width | Border width in pixels |
Highlight annotations
Overlay a semi-transparent color on elements. Useful for drawing attention to a specific area of the page.
| Property | Description |
|---|---|
| Selector | CSS selector for the target element(s) |
| Color | Overlay color (hex) |
| Opacity | Transparency 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.
.cookie-banner
#intercom-container
.notification-bar
[data-testid="chat-widget"]Tip