Tracking mouse movements


Experience Analytics (Tealeaf) UI Capture provides the capability to track mouse movements. Experience Analytics (Tealeaf) records mouse movements of users on webpages and simulates the movements in Replay. The mouse movement feature gives you more details about user behavior than heatmaps because you can see the mouse's path. With heatmaps you only see mouse clicks. This information allows designers to evaluate the website and redesign the UI for an improved user experience.

Note: The mouse movement feature tracks movements of the mouse cursor on a screen and cannot track movements on mobile devices.

Data Limit

Mouse movement data is recorded continuously. The limit is 1000 mouse positions for the current screenview. After the limit is reached, recording of mouse movements stops.


Use the following code to implement mouse movement in UIC.

mousemove: {
    enabled: true,
    sampleRate: 200,
    ignoreRadius: 3

The following table provides descriptions of the mouse movement properties.



To track mouse movements, enable the mouse movement feature by setting enabled to true. By default, enabled is set to false.


The sampleRate property specifies the periodic rate by which Experience Analytics (Tealeaf) records the mouse position. By default, the rate is every 200 milliseconds. For a smoother replay of mouse movement, you can lower sampleRate. To ensure an optimal rate for your needs, perform adequate testing.


The ignoreRadius property tells Experience Analytics (Tealeaf) to ignore recording a mouse position if the mouse is within the specified radius from the last recorded position. By default, Experience Analytics (Tealeaf) ignores recording a position if the mouse is within 3 pixels of the last position.

Updated 4 months ago

Tracking mouse movements

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.