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

# On-screen dock

> Use the floating dock to switch capture modes, record sessions, annotate, blur page content, and capture screenshots.

The on-screen dock keeps Puggy controls available on the page you are testing. Use it when you want to start recording, capture screenshots, annotate the page, or blur sensitive content without reopening the extension popup.

<img src="https://mintcdn.com/anoclap/XieyMMoK05GCm9U5/extension-dock.png?fit=max&auto=format&n=XieyMMoK05GCm9U5&q=85&s=c8be8db5e9dac31e7ec81cf4b1a2820e" alt="Puggy on-screen dock in Session mode" width="1406" height="112" data-path="extension-dock.png" />

## Show the dock

Enable **On-screen handler** in the extension popup before starting a capture. The dock appears on the active page and can be dragged to a different position.

Use the drag handle on the left side of the dock to move it. Use the close button on the right side to hide it.

## Switch capture mode

The **Mode** control opens a menu with three capture options:

<img src="https://mintcdn.com/anoclap/XieyMMoK05GCm9U5/extension-dock-mode-menu.png?fit=max&auto=format&n=XieyMMoK05GCm9U5&q=85&s=4eb3a363b6b6f7eb3d82448d794406ba" alt="Puggy dock mode switcher" width="864" height="308" data-path="extension-dock-mode-menu.png" />

| Mode       | Use it for                                                   |
| ---------- | ------------------------------------------------------------ |
| Session    | Record a full QA session with video and supporting evidence. |
| Screenshot | Capture a visible screenshot or selected region.             |
| Video only | Record a lightweight video-only session.                     |

Changing mode from the dock updates the same capture preference used by the extension popup.

## Recording controls

When the dock is in session or video-only mode, use the recording controls to:

* Start recording.
* Stop recording.
* Pause or resume recording.
* Take a screenshot during the recording.
* Capture an accessibility report when the feature is enabled.
* Toggle tab audio and microphone capture.

The timer shows the elapsed recording time. Screenshot and accessibility counts are not shown in the dock.

## Screenshot controls

When the dock is in screenshot mode, use the screenshot controls to:

<img src="https://mintcdn.com/anoclap/XieyMMoK05GCm9U5/extension-dock-screenshot-mode.png?fit=max&auto=format&n=XieyMMoK05GCm9U5&q=85&s=0e2a94439740d2a3e271dc2532b5c606" alt="Puggy on-screen dock in Screenshot mode" width="842" height="126" data-path="extension-dock-screenshot-mode.png" />

* Capture the visible area.
* Select and capture a region.
* Annotate the page before capture.
* Blur page elements before capture.

The dock and selector borders are hidden during screenshot capture, but live annotations and blurred elements remain visible in the captured image.

## Annotate the page

Use the annotation tool to draw directly on the page. The annotation toolbar includes:

* Pen
* Marker
* Text
* Eraser
* Color selection
* Clear annotations

Annotations are applied as a live page overlay, so they are captured in screenshots and recordings.

## Blur sensitive content

Use the blur tool to hide sensitive page content before recording or taking a screenshot.

1. Click the blur button.
2. Hover the page and click the element you want to blur.
3. The selected element is blurred immediately.
4. The blur selector turns off after the click.

Click the blur button again to blur or unblur another element. Use the reset button to clear all blurred elements.

<Tip>
  If you blur content before starting a recording, the blur remains active when recording starts and is captured in the video.
</Tip>

## Tooltips

Every dock button has a tooltip. Hover or focus a control to confirm what it does before clicking.
