More in Product analytics
- Build a funnel that explains drop-off
- Identify users across web, app and mini-programs
- What is autocapture, and how does it work?
- How do I review and accept events in the inbox?
- What are unplanned events, and how do I manage them?
- When should I use a funnel instead of a goal or path?
- How do I build a funnel?
- How do I read where a funnel drops off?
- What is identified mode, and should I turn it on?
- How do I call login to identify a user?
- How is one person merged across devices?
- How does identity work on apps and mini-programs?
- How do I track clicks on outbound links?
- How do I track file downloads?
- How do I track form submissions?
- How do I track custom events?
- How do I track button clicks?
- How do I create a heatmap?
- How do I track scroll depth?
- How do I track ecommerce purchases and revenue?
- How do I set up goals and track conversions?
- How do I query my data with SQL?
- How do I create a custom metric?
- How do I analyze accounts with groups?
- How do I connect AI agents with MCP?
- How do I ask the AI assistant about my data?
- How do I create user segments?
- How do I run an RFM analysis?
- How do I record and watch session replays?
- How do I analyze user paths?
- How do I build a retention report?
- How do I analyze how an event is distributed?
- How do I create a tracking plan?
- How do I view a user’s profile and activity?
- How do I read the lifecycle report (new, returning, resurrecting, dormant)?
- How do I compare attribution models for a conversion?
- All guides in this category
Still have a question?
Could not find it? A person reads every message, usually within a few hours on business days.
Chat with usAnswered step by step on their own pages:
- What is autocapture, and how does it work?
- How do I review and accept events in the inbox?
- What are unplanned events, and how do I manage them?
- How do I track clicks on outbound links?
- How do I track file downloads?
- How do I track form submissions?
- How do I track custom events?
- How do I track button clicks?
- How do I create a heatmap?
- How do I track scroll depth?
- How do I track ecommerce purchases and revenue?
How it works
Without autocapture, an event exists only when a developer adds a track() call. With autocapture on, the script records clickable elements — buttons, links, form submits — along with the page and the element's selector. Visible text is not captured by default, and password fields are always skipped.
Overnight, the inbox clusters the previous day's interactions by element and page and suggests a name for each cluster, either from a rule (a button whose id is signup) or from a model (a link in the pricing table). Nothing becomes an event until you accept it.
Autocapture is included from the Pro plan. On Free the inbox page explains that the plan does not include it; events from track() still work.
Turn it on
- Open InsightsProject settingsCollection and enable Autocapture. The script lazy-loads the autocapture module on the next pageview; nothing to redeploy.
- Wait one night, or click Generate candidates now in the inbox. The first run needs a day of traffic to have something to cluster.
- Open InsightsDataEvent inbox. Four tabs: Pending, Accepted, Ignored and Event definitions. Cards on top count pending candidates, unplanned events, defined events and verified installs.
Review a candidate
Each pending row shows hits and distinct people over the last 7 days, when it was last seen, and whether the name came from a rule or from AI. Filter by high or low confidence, or by "not seen for 3 days" to clear stale ones. Expand a row to see the 7-day trend, first seen, the pages it occurred on and the actions people took just before and after.
Three actions:
| Action | What it does |
|---|---|
| Accept | Asks for an event name (starts with a letter), a label, a category and a description. Creates a match rule and backfills the last 90 days of autocapture so funnels have history on day one. A large backfill can take a few minutes. |
| Merge | Adds this interaction to an existing event's rules — for example, a second "Buy" button on a new page — and backfills only the increment. |
| Ignore | Moves it to Ignored. It stays there and can be accepted later; it does not come back as pending. |
Accepting, merging and ignoring require the Analyst role or above.
Unplanned events
The inbox also lists names your code already sends that have no definition — typically a track('checkout_v2') someone added in a hurry. They keep being stored, so no data is lost, but they clutter the event picker. Give them a definition, or set the definition to Blocked to stop storing them.
The Event definitions tab doubles as your tracking plan: every official event, who owns it, when it was last seen. Export it before a release to check nothing broke.
Use the events
Accepted events appear immediately in funnels, retention, paths and segments under InsightsBehavior. The usual first step is a funnel from landing page to the accepted sign-up click. The full product tour is on the Insights page.
Did this answer your question?
We use your answers to fix and expand this page.
Couldn’t send. Please try again in a minute.
Thanks for the feedback. We’ll use it to improve this page.You’ve already sent feedback on this page. Thanks.