DocsForm engagement
Core concepts

Form engagement

A form submission is one moment. Everything that happened before it, or instead of it, is form engagement. It answers a question a plain submission count cannot: how far did someone get before they gave up.

The four states

A tracked form moves through, at most: viewed (at least half of it came on screen), started (a field was focused for the first time), and then either submitted or abandoned. Abandoned means started and not submitted: a form that was only seen, and never clicked into, stays viewed. It never goes backward. A form that reaches started cannot fall back to viewed just because a duplicate event arrives out of order.

Per-field timing

For every field the visitor touches, Jellyhook records how long they spent focused on it, in the order they filled the fields in. If someone fills the email field, moves on, then comes back later to fix it, both visits count toward its total, and each visit is kept on its own, so the pause between fields and the return to a field can be shown exactly. This is what the Form activity drawing on a lead's page is built from.

Reading the form drawing

Each form is drawn in three parts. At the top, a row of number tiles: how long before typing, the total activity on the form (first input until it was submitted or given up, pauses and time away included), time in fields, pausing, on other pages and away from the site, and how many fields were touched. Below that, the Timeline: the whole form on one line, in the order things happened, with pauses, other pages and time away as coloured blocks. Below the rule, the fields: one numbered row per field in the order they were used.

A field's bar has two parts: a light start (clicked in, nothing typed yet) and a solid part (typing). Each part carries its own seconds, for example 2 s in the light part and 11 s in the solid part: together the 13 seconds the field was in use. When the light part is too short for its seconds, one text sits on the solid part instead, such as "13 s (2 s before typing)": the 13 seconds already include the 2, they are not added. When the bar is too short for that, only the seconds are inside; when it is too short for any text, the seconds are written next to it. The lighter start of a bar is the time clicked in without typing yet. A field with a dashed outline was never touched. The Timeline is a summary of the rows beneath it, not a field: each field block in it carries the field's number and name above it (just the number when the block is narrow) and its seconds inside, matching the numbered rows below.

What else is recorded, and what never is

For each field: whether it was filled or left empty when the visitor moved on, how many times its value was changed, and how many times the browser refused the form because that field was invalid (for example a required field left empty). For each form: its list of fields with their type and whether they are required, so fields nobody touched can be shown, and how long the form was on screen before the visitor started. Nothing the visitor types is recorded, not even its length: only times, counts and yes or no. The values of a submitted lead form are captured as before, when it is submitted.

Leaving the page is not the same as abandoning the form

Switching tabs, or briefly visiting another page on the same site, does not mark a form abandoned. The visitor might come straight back and keep typing. A form only gets marked abandoned once the whole visit is over, not just the current page. When that happens, the abandoned time recorded is the real last moment they were doing something in the form, never the moment the system happened to notice they were gone.

A limitation worth knowing

This only sees fields a person focuses. A field filled by browser autofill without ever receiving a focus event, which happens in some browsers, will not show timing data, even though it was filled in. Validation errors are only the browser's own checks (required fields, email format); a site's own error messages are not seen. Forms filled before 14 October 2026 have totals only, so a field visited more than once is drawn as approximate.