Autocapture Events and Properties

This reference lists Autocapture event types and event property names for web when you use the Browser SDK 2. Use this reference to understand what Amplitude captures automatically, configure your tracking plan, or set up pipelines and validation.

For a machine-readable version of this page, go to Web Autocapture Schema. For native iOS and Android Autocapture event properties, go to Mobile Autocapture Schema.

Shared conventions

Property names in bold (for example, Page URL) reflect how they appear in Amplitude.
Autocapture prefixes some properties with [Amplitude]. Amplitude generates these automatically and marks them as read-only.
Configure which events Amplitude captures through AutocaptureOptions in the Browser SDK 2.

Sessions

Session started

Captures when a user session begins, either on first page load or after a period of inactivity.

Property Name	Description
No properties collected

Session ended

Captures when a user session ends due to inactivity or the browser tab closing.

Property Name	Description
No properties collected

Page views

Page viewed

Captures each time a user loads or navigates to a page, including single-page app route changes.

Property Name	Description
Page Domain	The full hostname from the current web address, including any subdomains such as `www` or `app`.
Page Location	The full URL of the current page, including any URL Search Parameters.
Page Path	The pathname of the current page. This excludes any URL Search Parameters and URL Fragments.
Page Title	The title of the page.
Page URL	The URL of the page excluding the URL Search Parameters.

File downloads

File downloaded

Captures when a user clicks a link that triggers a file download.

Property Name	Description
File Extension	The extension of the downloaded file. For example: .pdf, .docx, .zip, and so forth.
File Name	The full pathname of the downloaded file. This can include more than just the filename of the file.
Link ID	The ID of the link element.
Link Text	The text content of the link element.
Link URL	The link address of the file download.

Form interactions

Autocapture captures forms that use the <form> tag.

Form started

Captures when a user initially interacts with a form element, including modifications to a text input, radio button, or dropdown.

Property Name	Description
Form Destination	The action attribute of the form element. For example, for `<form action="/subscribe">`, the value is `/subscribe`.
Form ID	The ID of the form element.
Form Name	The name attribute of the form element.

Form submitted

Captures when a user submits the form.

Property Name	Description
Form Destination	The action attribute of the form element. For example, for `<form action="/subscribe">`, the value is `/subscribe`.
Form ID	The ID of the form element.
Form Name	The name attribute of the form element.

Element interactions

Element clicked

Captures clicks on page elements.

The default configuration captures user interactions with interactive elements on your page. The default eliminates event noise such as clicks to highlight text and white-space clicks. The default captures the following:

All clicks on form elements: <a>, button, input, select, text area, label, and elements where contentEditable is set to true.
All clicks on video and audio elements.
Clicks on select elements that result in a change on your page (for example, a modal appearing) or navigation to another page. These elements include divs, spans, and headers.
All clicks on elements with an attribute of data-amp-default-track or a class of amp-default-track.
You can customize this configuration to add or remove selectors. You can choose whether Amplitude always tracks those selectors or only when the click results in a change to the page.

Property Name	Description
Element ID	The `id` attribute of the HTML element. For example, an element with `id="myID"` produces the value `myID`.
Element Class	The `class` attribute of the HTML element. For example, an element with `class="myClass"` produces the value `myClass`.
Element Tag	The tag name of the HTML element. For example, an `<a>` element produces the value `a`.
Element Text	The text content (`innerText`) of the HTML element. Only applies to the Element Clicked event. For example, a link with text "Home" produces the value `Home`.
Element Href	The `href` attribute of the HTML element. Only applies to `<a>` tags on the Element Clicked event. Values longer than 128 bytes are truncated.
Element Position Left	The distance of the element from the left of the screen view, in pixels. For example, a value of `600` means the element was 600px from the left.
Element Position Top	The distance of the element from the top of the screen view, in pixels. For example, a value of `400` means the element was 400px from the top.
Viewport Height	The height of the viewport in pixels when the element was clicked. For example, a value of `900` means the viewport was 900 pixels tall.
Viewport Width	The width of the viewport in pixels when the element was clicked. For example, a value of `1200` means the viewport was 1200 pixels wide.
Page URL	The URL of the page where the element was clicked.
Page Title	The page title of the page where the element was clicked.
Element Hierarchy	DOM elements and attributes of the element clicked and its parent or sibling elements. Amplitude uses this for visual labeling.
Element Selector	Deprecated in favor of Element Hierarchy. A unique CSS selector of the element. For example, an element with `id="myID"` produces the value `#myID`.
Element Attributes	Unique attributes associated with click events through the `dataAttributePrefix` setting. For example, an element with attribute `id="feature-start"` produces a property `[Amplitude] Element Attributes.id` with the value `feature-start`.
Element Aria Label	The `aria-label` of the element, used for interactive elements without visible text. For example, an element with `aria-label="Close"` produces the value `Close`.
Element Parent Label	The text label in the parent element (or upper ancestors if not found in the one-level parent) of the element.

Element changed

Captures form element interactions, such as changes to a dropdown or entering text in a text box.

Property Name	Description
Element ID	The `id` attribute of the HTML element.
Element Class	The `class` attribute of the HTML element.
Element Tag	The tag name of the HTML element.
Element Position Left	The distance of the element from the left of the screen view, in pixels.
Element Position Top	The distance of the element from the top of the screen view, in pixels.
Viewport Height	The height of the viewport in pixels when the element changed.
Viewport Width	The width of the viewport in pixels when the element changed.
Page URL	The URL of the page where the element changed.
Page Title	The page title of the page where the element changed.
Element Hierarchy	DOM elements and attributes of the element changed and its parent or sibling elements. Amplitude uses this for visual labeling.
Element Selector	Deprecated in favor of Element Hierarchy. A unique CSS selector of the element.
Element Attributes	Unique attributes associated with change events through the `dataAttributePrefix` setting.
Element Aria Label	The `aria-label` of the element, used for interactive elements without visible text.
Element Parent Label	The text label in the parent element (or upper ancestors if not found in the one-level parent) of the element.

Network requests

Captures when the application makes a network request. By default, Amplitude tracks network requests with a response code in the range 500-599 and excludes requests made to any amplitude.com domain.

To enable network request tracking, set config.autocapture.networkTracking to true in your SDK configuration.

Property Name	Description
[Amplitude] URL	The URL of the network request with sensitive information masked.
[Amplitude] URL Query	The query parameters of the URL.
[Amplitude] URL Fragment	The fragment identifier of the URL.
[Amplitude] Request Method	The HTTP method used for the request (for example, GET, POST, PUT, or DELETE).
[Amplitude] Status Code	The HTTP status code of the response.
[Amplitude] Error Code	The local error code if the request failed without a status code.
[Amplitude] Error Message	The local error message if the request failed without a status code.
[Amplitude] Start Time	The timestamp when the request started, in milliseconds since Unix epoch.
[Amplitude] Completion Time	The timestamp when the request completed, in milliseconds since Unix epoch.
[Amplitude] Duration	The duration of the request in milliseconds.
[Amplitude] Request Body Size	The size of the request body in bytes.
[Amplitude] Response Body Size	The size of the response body in bytes.
[Amplitude] Request Body	The captured JSON request body (when you configure a `requestBody` capture rule).
[Amplitude] Response Body	The captured JSON response body (when you configure a `responseBody` capture rule).

For more information about configuring network tracking, including advanced capture rules and filtering options, refer to Track network requests in the Browser SDK 2 documentation.

Web Vitals

Captures Core Web Vitals performance metrics when the browser tab hides.

Property Name	Description
Page Domain	The full hostname from the current web address, including any subdomains such as `www` or `app`.
Page Location	The full URL of the current page, including any URL Search Parameters.
Page Path	The pathname of the current page. This excludes any URL Search Parameters and URL Fragments.
Page Title	The title of the page.
Page URL	The URL of the page excluding the URL Search Parameters.
LCP (Largest Contentful Paint)	The time it takes for the largest content element to become visible in the viewport. Measured in milliseconds.
FCP (First Contentful Paint)	The time it takes for the first content element to be painted on the screen. Measured in milliseconds.
INP (Interaction to Next Paint)	The time from a user interaction to the next paint. Measured in milliseconds.
CLS (Cumulative Layout Shift)	The sum of all individual layout shift scores for unexpected layout shifts. A dimensionless value.
TTFB (Time to First Byte)	The time from the navigation start to when the first byte of the response is received. Measured in milliseconds.

Each metric includes a performance rating (good, needs-improvement, or poor) based on Web Vitals thresholds and timing data.

Was this helpful?