---
title: Autocapture
description: Track clicks, rage clicks, dead clicks, form interactions, and media playback automatically without any code
url: https://www.supalytics.co/docs/autocapture
---



Autocapture automatically records user interactions without any additional code. The tracking script detects clicks, form submissions, media playback, and UX issues like rage clicks and dead clicks.

<img alt="Autocapture events in the dashboard" src="/docs/autocapture.webp" width="1196" height="1124" />

**Autocapture events are free for now** and don't count toward your monthly event quota. Only pageviews and custom events count toward billing.

## What Gets Tracked

| Event                | Description                                                      |
| -------------------- | ---------------------------------------------------------------- |
| **Clicks**           | All clicks on interactive elements (buttons, links, etc.)        |
| **Rage Clicks**      | Rapid repeated clicks indicating user frustration                |
| **Dead Clicks**      | Clicks on non-interactive elements that don't trigger any action |
| **Form Submissions** | When users submit forms                                          |
| **Form Abandonment** | When users start filling a form but leave without submitting     |
| **Media Play**       | When users start playing videos or audio                         |

## How It Works

Autocapture is handled by the same tracking script you already have installed. No additional setup required.

```html
<script
  defer
  data-site="YOUR_SITE_ID"
  src="https://cdn.supalytics.co/script.js"
></script>
```

## Viewing Autocapture Events

Autocapture events appear in two places:

### 1. Events Breakdown

On your main dashboard, autocapture events show up in the Events card alongside your custom events. They're labeled with badges like "clicks", "rage", "dead", etc.

### 2. Visitor Journey

When viewing an individual visitor's timeline, you'll see autocapture events inline with pageviews and custom events. Hover over any event to see:

* **Page** - Which page the interaction happened on
* **Section** - The nearest heading (helps identify page area)
* **Element** - The HTML element type (`<button>`, `<a>`, etc.)
* **ID** - Element's ID attribute if present
* **Link** - Destination URL for link clicks
* **Clicks** - Number of clicks for rage click events

## Understanding UX Issues

### Rage Clicks

Rage clicks are detected when a user clicks the same element 3+ times within 500ms. This typically indicates:

* A button that appears clickable but isn't working
* Slow response times frustrating users
* Unclear UI feedback after clicking

### Dead Clicks

Dead clicks are detected when a user clicks an element and nothing happens within 1 second - no navigation, no DOM changes, no network requests. Common causes:

* Broken links or buttons
* JavaScript errors preventing handlers from running
* Elements that look clickable but aren't (missing `cursor: pointer` misleading users)

**Note**: Dead click detection automatically ignores navigation events. If a click triggers a page navigation, it won't be marked as dead.

## Event Properties

Each autocapture event includes contextual properties:

| Property          | Description                                                  |
| ----------------- | ------------------------------------------------------------ |
| `element_text`    | Text content of the clicked element (truncated to 100 chars) |
| `element_tag`     | HTML tag name (`button`, `a`, `div`, etc.)                   |
| `element_id`      | Element's ID attribute                                       |
| `element_href`    | Link destination for anchor tags                             |
| `nearest_heading` | Text of the closest heading element (h1-h6)                  |
| `click_count`     | Number of clicks (for rage clicks)                           |

## Filtering Autocapture Events

In the Events breakdown, you can click on any autocapture event type to filter your dashboard by visitors who triggered that event. This helps you:

* Find pages with the most dead clicks
* Identify which elements cause rage clicks
* See conversion rates for users who experienced UX issues

## Comparison with Custom Events

| Feature         | Autocapture                 | Custom Events                 |
| --------------- | --------------------------- | ----------------------------- |
| Setup required  | None                        | Add tracking code             |
| What's captured | All interactions            | Only what you specify         |
| Control         | Automatic                   | Full control                  |
| Use case        | UX issues, general behavior | Specific conversions, funnels |

**Recommendation**: Use autocapture to discover UX issues and understand general behavior patterns. Use [custom events](/docs/custom-events) for tracking specific conversions and building funnels.

## Privacy

Autocapture follows the same privacy rules as all Supalytics tracking:

* No personal data is collected
* Element text is truncated and sanitized
* No tracking of input field values (except form field names)
* Respects Do Not Track browser settings
* GDPR compliant


---

## Other Documentation

- [Backfill Existing Subscriptions](https://www.supalytics.co/llms/docs/backfill-existing-subscriptions)
- [Block Your Own Traffic](https://www.supalytics.co/llms/docs/block-your-traffic)
- [CLI](https://www.supalytics.co/llms/docs/cli)
- [Custom Events](https://www.supalytics.co/llms/docs/custom-events)
- [Features](https://www.supalytics.co/llms/docs/features)
- [Conversion Funnels](https://www.supalytics.co/llms/docs/funnels)
- [Introduction](https://www.supalytics.co/llms/docs)
- [Install Script](https://www.supalytics.co/llms/docs/install-script)
- [MRR Tracking](https://www.supalytics.co/llms/docs/mrr-tracking)
- [Revenue Attribution](https://www.supalytics.co/llms/docs/revenue-attribution)
- [Agent Skills](https://www.supalytics.co/llms/docs/skills)
- [Tracking Modes](https://www.supalytics.co/llms/docs/tracking-modes)
- [Visitor Journey](https://www.supalytics.co/llms/docs/visitor-journey)
- [Annotations](https://www.supalytics.co/llms/docs/api/annotations)
- [Error Codes](https://www.supalytics.co/llms/docs/api/errors)
- [Events (Read)](https://www.supalytics.co/llms/docs/api/events)
- [API Reference](https://www.supalytics.co/llms/docs/api)
- [Journeys](https://www.supalytics.co/llms/docs/api/journeys)
- [Query API](https://www.supalytics.co/llms/docs/api/query)
- [Realtime API](https://www.supalytics.co/llms/docs/api/realtime)
- [Revenue Attribution API](https://www.supalytics.co/llms/docs/api/revenue-attribution)
- [Events (Write)](https://www.supalytics.co/llms/docs/api/server-side-events)