Skip to content

Event schema

timestamp_ms counts milliseconds since the SDK started on the page (performance.now(), 0.1 ms resolution); it is not wall-clock time. x and y are viewport CSS pixels.

modality event_type Fields Notes
keystroke keydown key_code key_char field_id Auto-repeats are recorded but keep the first press as the hold start.
keystroke keyup key_code key_char hold_ms field_id hold_ms = release minus the first press of that key.
keystroke input field_len field_id Length of the field's value after a change (0 to 100,000). The value never leaves the page.
mouse move x y button=0 At most one per 16 ms.
mouse down, up x y button button: 1 left, 2 right, 3 middle, -1 other.
mouse scroll x y sensor_x sensor_y x, y = pointer position; sensor_x, sensor_y = wheel delta. At most one per 16 ms.
touch start, move, end, cancel x y pressure sensor_x sensor_y One event per changed touch point; sensor_x, sensor_y = contact radius; pressure only where the device reports force. Moves at most one per 16 ms.

Keep personal data out of field ids

field_id is the focused element's id, else its name, else its tag name, truncated to 64 characters, and it is sent as is. Keep personal data out of element ids and names on monitored pages.