Autocapture and element naming

What is captured automatically

Event	When	Details
page_view	Page load and single-page-app navigations (pushState, replaceState, popstate, plus hashchange if hashRouting)	New page view ID per page
page_leave	Tab hidden, page closed, before an SPA navigation	Engaged time (visible and focused) and maximum scroll depth
click, outbound_click, download	Click on a link, button, [role=button], [onclick] or [data-ah-name] element	Selector, tag, text (≤ 100 characters, emails and long numbers masked), id, stable classes, link (sensitive parameters removed), role, data-ah-name, click position, whether the click was produced by a real input device
form_start, form_submit, form_abandon	First field focus, submit, page left after starting without submitting	Field values are never read: only the form's selector, id or name and the last field touched
scroll	25, 50, 75 and 90% depth
error	JavaScript errors and unhandled promise rejections	At most 10 per page, de-duplicated
web_vitals	First page leave of the landing page	LCP, INP, CLS, TTFB
actor_switch	The actor changes within a session	From, to, agent name
consent_update	The consent mode changes	New and previous mode

Text inputs, text areas and selects are never captured.

Name your important elements

Funnels and click reports identify elements by a CSS selector. Selectors built automatically survive most changes, but a redesign can still break them. Give the elements you care about a stable business name:

<button data-ah-name="add-to-cart">Add to cart</button>
<div class="slot-picker" data-ah-name="delivery-slot-picker">…</div>
<a href="/checkout" data-ah-name="checkout">Checkout</a>

data-ah-name becomes the anchor of the element's selector, and the name shown in reports and in the funnel builder's element picker.

When there is no name, the selector generator prefers, in order: a stable id, a test or stable attribute (data-testid, data-test, data-qa, data-cy, name…), then tag + stable classes + :nth-of-type. It ignores framework-generated ids (React :r1:, ember123, radix-*), CSS-in-JS hashes (css-1x2y3z, sc-*, Button_root__a1B2c) and state classes (active, is-open). It climbs at most 6 levels and returns the shortest unique path.

Hide or mask elements

Attribute	Effect
data-ah-ignore	Clicks on the element are not captured
data-ah-mask (or class ah-mask)	Text inside the element is replaced by ***

<div class="account-summary" data-ah-mask>Jane Doe · jane@example.com</div>

Turn parts off

eureka('config', { autocapture: { forms: false, scroll: false } })