LEVEL Agency
Measurement Docs

Event Reference (v1) / Form Events

Form Step Submit form_step_submit

When user submits a step in a multi-step form. This event should ONLY fire if the step data passed validation.

  • Name
    Event Name Required
    Value
    event: form_step_submit

Step Properties

These properties apply to all form_step_* events.

  • Name
    Step ID Required
    Type
    step_id: integer|string
    Description

    The unique identifier for the form step. This can be as simple and as a HTML id attribute. Or it can be a native form step ID from a CMS or other system.

    E.g.
    gform_page_1_2
  • Name
    Step Index Required
    Type
    step_index: integer
    Description

    The index of the form step in the form. Ideally, this value passed is 1-based, not zero-based (for better user understanding).

    E.g.
    2
  • Name
    Step Input Count Optional
    Type
    step_input_count: integer
    Description

    The number of visible fields/inputs in the form step. Visible field count can be obtained via something like Element.querySelectorAll('input:not([type=hidden]):not([type=submit]), select, textarea').length.

    E.g.
    4
  • Name
    Step Name Optional
    Type
    step_name: string
    Description

    A human readable step name for the form step.

    E.g.
    Contact Information

Form Properties

These properties apply to all form_* events.

  • Name
    Form ID Required
    Type
    form_id: integer|string
    Description

    The unique identifier for the form. This can be as simple and as a HTML id attribute. Or it can be a native form ID from a CMS or other system.

    E.g.
    0d7fb0da-a3a6-49ad-9c29-d7fbcd56f3b1
  • Name
    Form Group Optional
    Type
    form_group: string
    Description

    The group or category of the form (e.g. Demo Request, or Webinar Registration). This can be used to group forms together for reporting purposes.

    E.g.
    Demo Request
  • Name
    Form Name Optional
    Type
    form_name: string
    Description

    A human readable name for the form. These should be dynamically set from the system that provides the form.

    E.g.
    Inbound Sales - Request a Demo
  • Name
    Form Provider Optional
    Type
    form_provider: string
    Description

    The name of the system/platform that provides the form (e.g. HubSpot, Marketo etc...). This can be useful when more than one form provider is in use (e.g. HubSpot and Gravity Forms).

    E.g.
    HubSpot

© 2026 Level Agency.