Event Reference (v1) / Form Events
Form Step Load / form_step_load
When a step in a multi-step form is viewed/loaded. This event applies to both forward and backward navigation through steps.
-
- Name
- Event Name Required
- Value
- event: form_step_load
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
idattribute. 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
idattribute. 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