Gravity Forms Hook Reference

A reference guide for which Gravity Forms hooks are called and in what order for several typical scenarios. Provides additional information for those seeking a deeper understanding into how Gravity Forms actually works.

Last updated January 16, 2022 | Written by David Smith 43 Comments

The goal of this reference is to give you a general idea of the order in which Gravity Forms’ hooks are called in several typical scenarios. Click on the “More Info” link that appears when you hover over a hook to reveal additional details about the hook and its purpose. Many hooks also contain a “Digging Deeper” section. These sections offer helpful advice and useful insights into how Gravity Forms works.

Toggle the filters and actions off to see the top-level flow of a Gravity Forms scenario.

Hooks Run for Initial Form Load
Hooks Run on Form Submission with Validation Error
Hooks Run on Successful Form Submission

Hooks Run for Initial Form Load

toggle: Filters | Action

Enqueue Scripts more info

It all begins with WordPress' wp_enqueue_scripts action.

This action triggers Gravity Forms' GFFormDisplay::enqueue_scripts() function. In this function, Gravity Forms determines if it needs to load any form scripts. To determine this, Gravity Forms will call the GFFormDisplay::get_embedded_forms() function. This function will search the content of all queried posts for the currrent page for the Gravity Forms shortcode (i.e. [gravityforms id="1" /]).

gform_form_post_get_meta | filter more info

Use this filter to modify the form meta at the earliest possible point in the Gravity Forms form loading process. This filter will be applied once per form per page load as the form meta is cached until the next page load.

Digging Deeper
Gravity Forms has found a form that will be displayed on this page. It fetches the form meta (the data that controls all of the form's options) via the GFFormsModel::get_form_meta() method (note: you should use GFAPI::get_form() to get the form meta). This filter is applied within the get_form_meta() method after the meta has been retrieved.

called by GFFormsModel::get_form_meta() in forms_model.php
gform_form_post_get_meta_{form_id} | filter more info

Form-specific version of the gform_form_post_get_meta filter. Example: gform_form_post_get_meta_1

Use this filter to modify the form meta at the earliest possible point in the Gravity Forms form loading process. This filter will be applied once per form per page load as the form meta is cached until the next page load.

Digging Deeper
Gravity Forms has found a form that will be displayed on this page. It fetches the form meta (the data that controls all of the form's options) via the GFFormsModel::get_form_meta() method (note: you should use GFAPI::get_form() to get the form meta). This filter is applied within the get_form_meta() method after the meta has been retrieved.

called by GFFormsModel::get_form_meta() in forms_model.php
gform_pre_enqueue_scripts | action more info

Use this action to enqueue form scripts before Gravity Forms has enqueued it's own scripts.

Digging Deeper
Gravity Forms has retrieved the form meta and and is now ready to enqueue the neccesary scripts for the forms that have been found. GFFormDisplay::enqueue_form_scripts() will enqueue all form scripts (and styles) required by the current form. The enqueue_form_scripts() method will trigger the "gform_pre_enqueue_scripts" action before the Gravity Forms scripts have been enqueued.

called by GFFormsModel::enqueue_form_scripts() in form_display.php
gform_pre_enqueue_scripts_{form_id} | action more info

Form-specific version of the gform_pre_enqueue_scripts action. Example: gform_pre_enqueue_scripts_1

Use this action to enqueue form scripts before Gravity Forms has enqueued it's own scripts.

Digging Deeper
Gravity Forms has retrieved the form meta and and is now ready to enqueue the neccesary scripts for the forms that have been found. GFFormDisplay::enqueue_form_scripts() will enqueue all form scripts (and styles) required by the current form. The enqueue_form_scripts() method will trigger the "gform_pre_enqueue_scripts" action before the Gravity Forms scripts have been enqueued.

called by GFFormsModel::enqueue_form_scripts() in form_display.php
gform_has_conditional_logic | filter more info

Use this filter to override the GFFormDisplay::has_conditional_logic() check. If conditional logic has been enabled on the current form, this check will return true by default.

Digging Deeper
The GFFormDisplay::enqueue_form_scripts() method calls the GFFormDisplay::has_conditional_logic() method to determine whether or not to load Gravity Forms' conditional logic script (conditional_logic.js). The has_conditional_logic() method applys the "gform_has_conditional_logic" filter to allow overriding this check.

This is most commonly used to enable conditional logic on forms with custom-coded conditional logic support rather than disabling conditional logic on forms that are using Gravity Forms' default conditional logic.

called by GFFormDisplay::has_conditional_logic() in form_display.php
gform_has_conditional_logic | filter more info

Use this filter to override the GFFormDisplay::has_conditional_logic() check. If conditional logic has been enabled on the current form, this check will return true by default.

Digging Deeper
The GFFormDisplay::has_conditional_logic() method is called a second time in the GFFormDisplay::enqueue_form_scripts() method to determine whether or not the "common" Gravity Forms script file should be loaded (gravityforms.js). This file should always be loaded if conditional logic is enabled.

called by GFFormDisplay::has_conditional_logic() in form_display.php
gform_enqueue_scripts | action more info

Use this action to enqueue form scripts after Gravity Forms has enqueued its own scripts. This is the preferred hook to use for enqueueing your own form scripts.

Digging Deeper
All form scripts for the current form have now been enqueued.

called by GFFormDisplay::enqueue_form_scripts() in form_display.php
gform_enqueue_scripts_{form_id} | action more info

Form-specific version of the gform_enqueue_scripts action. Example: gform_enqueue_scripts_1

Use this action to enqueue form scripts after Gravity Forms has enqueued its own scripts. This is the preferred hook to use for enqueueing your own form scripts.

Digging Deeper
All form scripts for the current form have now been enqueued.

called by GFFormDisplay::enqueue_form_scripts() in form_display.php

Form Markup more info

The post content is about to be displayed and Gravity Forms' shortcode is being parsed. The GFFormDisplay::get_form() method has been called to fetch the complete form markup that will then be output to the page. All of the hooks called in this section originate from the get_form() method.

gform_form_args | filter more info

Use this filter to override the default arguments that will be used to render the form (i.e. "id", "display_title", "display_description", "ajax", "tabindex", etc). These arguments are specified in the shortcode or via the gravity_form() function.

Digging Deeper
The get_form() method applys this filter immediately allowing you to override form display argument before any form markup has been generated.

This would allow you to do things like enable AJAX for all forms or dynamically populate the form via the "field_values" argument.

called by GFFormDisplay::get_form() in form_display.php
gform_disable_view_counter | filter more info

Use this filter to prevent the current form load from counting as a form view.

Digging Deeper
This is useful in cases where you may be fetching the form markup via the GFFormDisplay::get_form() method (outside of the normal Gravity Forms form load flow) but not displaying it.

called by GFFormDisplay::get_form() in form_display.php
gform_disable_view_counter_{form_id} | filter more info

Form-specific version of the gform_disable_view_counter filter. Example: gform_disable_view_counter_1

Use this filter to prevent the current form load from counting as a form view.

Digging Deeper
This is useful in cases where you may be fetching the form markup via the GFFormDisplay::get_form() method (outside of the normal Gravity Forms form load flow) but not displaying it.

called by GFFormDisplay::get_form() in form_display.php
gform_pre_render | filter more info

Use this filter to modify the $form object before the form markup is generated.

Digging Deeper
Gravity Forms is about to generate the form markup. This is the preferred filter for modifying the $form object (including its $field objects) before the form markup is generated.

If you want to modify the markup for a field, use gform_field_input or gform_field_content.

called by GFFormDisplay::get_form() in form_display.php
gform_pre_render_{form_id} | filter more info

Form-specific version of the gform_pre_render filter. Example: gform_pre_render_1

Use this filter to modify the $form object before the form markup is generated.

Digging Deeper
Gravity Forms is about to generate the form markup. This is the preferred filter for modifying the $form object (including its $field objects) before the form markup is generated.

If you want to modify the markup for a field, use gform_field_input or gform_field_content.

called by GFFormDisplay::get_form() in form_display.php
gform_tabindex | filter more info

Use this filter to modify the tabindex start value (default is 0) or to disable the tabindex attribute.

Digging Deeper
For a helpful snippet on resolving most tabindex issues, see this.

called by GFFormDisplay::get_form() in form_display.php
gform_tabindex_{form_id} | filter more info

Form-specific version of the gform_tabindex filter. Example: gform_tabindex_1

Use this filter to modify the tabindex start value (default is 0) or to disable the tabindex attribute.

Digging Deeper
For a helpful snippet on resolving most tabindex issues, see this.

called by GFFormDisplay::get_form() in form_display.php
gform_pre_enqueue_scripts | action more info

Use this action to enqueue form scripts before Gravity Forms has enqueued it's own scripts.

Digging Deeper
Gravity Forms makes a second call to the GFFormDisplay::enqueue_form_scripts() method so that Gravity Forms scripts/styles are properly enqueued when the form is being loaded via the gravity_form() function call, rather than the shortcode.

If you're loading your form via the shortcode, you can ignore this. It won't cause you any issues.

called by GFFormsModel::enqueue_form_scripts() in form_display.php
gform_pre_enqueue_scripts_{form_id} | action more info

Form-specific version of the gform_pre_enqueue_scripts action. Example: gform_pre_enqueue_scripts_1

Use this action to enqueue form scripts before Gravity Forms has enqueued it's own scripts.

Digging Deeper
Gravity Forms makes a second call to the GFFormDisplay::enqueue_form_scripts() method so that Gravity Forms scripts/styles are properly enqueued when the form is being loaded via the gravity_form() function call, rather than the shortcode.

If you're loading your form via the shortcode, you can ignore this. It won't cause you any issues.

called by GFFormsModel::enqueue_form_scripts() in form_display.php
gform_has_conditional_logic | filter more info

Use this filter to override the GFFormDisplay::has_conditional_logic() check. If conditional logic has been enabled on the current form, this check will return true by default.

called by GFFormDisplay::has_conditional_logic() in form_display.php
gform_has_conditional_logic | filter more info

Use this filter to override the GFFormDisplay::has_conditional_logic() check. If conditional logic has been enabled on the current form, this check will return true by default.

called by GFFormDisplay::has_conditional_logic() in form_display.php
gform_enqueue_scripts | action more info

Use this action to enqueue form scripts after Gravity Forms has enqueued its own scripts. This is the preferred hook to use for enqueueing your own form scripts.

called by GFFormDisplay::enqueue_form_scripts() in form_display.php
gform_enqueue_scripts_{form_id} | action more info

Form-specific version of the gform_enqueue_scripts action. Example: gform_enqueue_scripts_1

Use this action to enqueue form scripts after Gravity Forms has enqueued its own scripts. This is the preferred hook to use for enqueueing your own form scripts.

called by GFFormDisplay::enqueue_form_scripts() in form_display.php
gform_is_form_editor | filter more info

Use this filter to override the GFCommon::is_form_editor() check.

Digging Deeper
Forms are displayed differently depending on the location in which they are loaded.

This filter is applied by the GFCommon::is_form_editor() method. The GFFormDisplay::get_form() method calls the is_form_editor() method to determine if the form is being loaded in the form editor. By default, this will return false if loading the form on the frontend.

called by GFCommon::is_form_editor() in common.php
gform_is_entry_detail | filter more info

Use this filter to override the GFCommon::is_entry_detail() check.

Digging Deeper
Forms are displayed differently depending on the location in which they are loaded.

This filter is applied by the GFCommon::is_entry_detail() method. The GFFormDisplay::get_form() method calls the is_entry_detail() method to determine if the form is being loaded in the entry detail view. By default, this will return false if loading the form on the frontend.

called by GFCommon::is_entry_detail() in common.php
gform_has_conditional_logic | filter more info

Use this filter to override the GFFormDisplay::has_conditional_logic() check. If conditional logic has been enabled on the current form, this check will return true by default.

Digging Deeper
This filter is called by the GFFormDisplay::has_conditional_logic() method. The GFFormDisplay::get_form() method calls the has_conditional_logic() method to determine if the form is any conditional logic enabled. If so, the form will be hidden by default. This prevents an awkward first-load experience where fields are shown/hidden depending on the conditional logic rules. After the conditional logic has been applied, Gravity Forms will automatically reveal the form.

called by GFFormDisplay::has_conditional_logic() in form_display.php
gform_confirmation_anchor | filter more info

Use this filter to enable or disable the confirmation anchor functionality.

Digging Deeper
When enabled, Gravity Forms will automatically scroll the page to the confirmation message upon submission. Provide a numeric value (in pixels) to force the page to scroll to a specified distance from the top of the page. This is useful when embedding forms in a long page.

called by GFFormDisplay::get_form() in form_display.php
gform_confirmation_anchor_{form_id} | filter more info

Form-specific version of the gform_confirmation_anchor filter. Example: gform_confirmation_anchor_1

Use this filter to enable or disable the confirmation anchor functionality.

Digging Deeper
When enabled, Gravity Forms will automatically scroll the page to the confirmation message upon submission. Provide a numeric value (in pixels) to force the page to scroll to a specified distance from the top of the page. This is useful when embedding forms in a long page.

called by GFFormDisplay::get_form() in form_display.php
gform_form_tag | filter more info

Use this filter to modify the markup of the <form> HTML tag.

called by GFFormDisplay::get_form() in form_display.php
gform_form_tag_{form_id} | filter more info

Form-specific version of the gform_form_tag filter. Example: gform_form_tag_1

Use this filter to modify the markup of the <form> HTML tag.

called by GFFormDisplay::get_form() in form_display.php

Field Markup Loop more info

Gravity Forms is still generating the form markup in the GFFormDisplay::get_form() method. Gravity Forms is now looping through each field on the form and generating the field markup. The following filters will be called for each field.

gform_is_form_editor | filter more info

Use this filter to override the GFCommon::is_form_editor() check.

Digging Deeper
Fields are displayed differently in the form editor than on the frontend. Gravity Forms needs to know where we are displaying the field. If the form is being loaded on the frontend, this filter will be return false by default.

Note: this filter is called repeatedly throughout the field markup loop. The remaining calls are not listed here.

called by GFCommon::is_form_editor() in common.php
gform_is_entry_detail | filter more info

Use this filter to override the GFCommon::is_entry_detail() check.

Digging Deeper
Fields are displayed differently in the entry detail than on the frontend. Gravity Forms needs to know where we are displaying the field. If the form is being loaded on the frontend, this filter will be return false by default.

Note: this filter is called repeatedly throughout the field markup loop. The remaining calls are not listed here.

called by GFCommon::is_entry_detail() in common.php
gform_field_css_class | filter more info

Use this filter to add or remove CSS classes for the current field.

called by GFFormDisplay::get_field() in form_display.php
gform_field_css_class_{form_id} | filter more info

Form-specific version of the gform_field_css_class filter. Example: gform_field_css_class_1

Use this filter to add or remove CSS classes for the current field.

called by GFFormDisplay::get_field() in form_display.php
gform_duplicate_field_link | filter more info

Digging Deeper
Ignore. This filter is used when viewing the form in the form editor and probably should not be applied when the form is loaded on the frontend.

called by in
gform_delete_field_link | filter more info

Digging Deeper
Ignore. This filter is used when viewing the form in the form editor and probably should not be applied when the form is loaded on the frontend.

called by in
gform_replace_merge_tags | filter more info

Use this filter to replace custom merge tags.

Digging Deeper
This instance of the filter is replacing merge tags populated into the Default Value setting of the current field.

called by GFCommon::replace_variables_prepopulate() in common.php
gform_field_input | filter more info

Use this filter to generate custom markup for the current field's input(s).

Digging Deeper
At the time this filter is called, the input markup has not yet been generated. This filter passes an empty string. If you return anything other than an empty string, it will be used instead of the default input markup.

called by GFCommon::get_field_input() in common.php
gform_replace_merge_tags | filter more info

Use this filter to replace custom merge tags.

Digging Deeper
This instance of the filter is replacing merge tags populated into the Placeholder setting of the current input of the current field.

called by GFCommon::replace_variables() in common.php
gform_field_content | filter more info

Use this filter to modify the label and input markup of the current field.

Digging Deeper
If the field has multiple inputs, all labels and inputs will be present. This filter differs from the gform_field_input filter in that it passes the default markup which can be modified and returned.

called by GFFormDisplay::get_field_content() in form_display.php
gform_field_container | filter more info

Use this filter to modify the complete markup of the current field. This includes the <li> container that wraps each field.

called by GFFormDisplay::get_field() in form_display.php
gform_field_container_{form_id} | filter more info

Form-specific version of the gform_field_container filter. Example: gform_field_container_1

Use this filter to modify the complete markup of the current field. This includes the <li> container that wraps each field.

called by GFFormDisplay::get_field() in form_display.php
gform_field_container_{form_id}_{field_id} | filter more info

Field-specific version of the gform_field_container filter. Example: gform_field_container_1_2

Use this filter to modify the complete markup of the current field. This includes the <li> container that wraps each field.

called by GFFormDisplay::get_field() in form_display.php

gform_submit_button | filter more info

Use this filter to modify the current form's submit button.

Digging Deeper
This filter is commonly used to convert the submit button from an <input type="submit" /> to an actual <button>. This allows the use of HTML inside the button for general fanciness.

called by GFFormDisplay::gform_footer() in form_display.php
gform_submit_button_{form_id} | filter more info

Form-specific version of the gform_submit_button filter. Example: gform_submit_button_1

Use this filter to modify the current form's submit button.

Digging Deeper
This filter is commonly used to convert the submit button from an <input type="submit" /> to an actual <button>. This allows the use of HTML inside the button for general fanciness.

called by GFFormDisplay::gform_footer() in form_display.php
gform_has_conditional_logic | filter more info

Use this filter to override the GFFormDisplay::has_conditional_logic() check. If conditional logic has been enabled on the current form, this check will return true by default.

Digging Deeper
This specific check is to determine whether or not the conditional logic initialization script should be loaded.

called by GFFormDisplay::has_conditional_logic() in form_display.php
gform_register_init_scripts | action more info

Use this action to register your own init scripts.

Digging Deeper
Init scripts are inline JS scripts that are output along with the form markup and trigger the necessary JS functionality when the form is fully loaded.

called by GFFormDisplay::register_form_init_scripts() in form_display.php
gform_register_init_scripts_{form_id} | action more info

Form-specific version of the gform_register_init_scripts action. Example: gform_register_init_scripts_1

Use this action to register your own init scripts.

Digging Deeper
Init scripts are inline JS scripts that are output along with the form markup and trigger the necessary JS functionality when the form is fully loaded.

called by GFFormDisplay::register_form_init_scripts() in form_display.php
gform_init_scripts_footer | filter more info

Use this filter to output Gravity Forms' init scripts in the footer rather than along with the form markup.

Digging Deeper
This is useful when a script file required by an init script is ouput in the footer rather than the header. For example, if you wanted to load jQuery in the footer, you would need to set this to true so that the init scripts (which depend on jQuery) would load after jQuery has been loaded.

called by GFFormDisplay::get_form() in form_display.php
gform_cdata_open | filter more info

Use this filter to wrap Gravity Forms' inline scripts in CDATA tags.

Digging Deeper
This is required for valid XHTML. Most themes use HTML5 now which does not require CDATA tags for validation.

called by GFFormDisplay::get_form() in form_display.php
gform_cdata_close | filter more info

Use this filter to wrap Gravity Forms' inline scripts in CDATA tags.

Digging Deeper
This is required for valid XHTML. Most themes use HTML5 now which does not require CDATA tags for validation.

called by GFFormDisplay::get_form() in form_display.php
gform_get_form_filter | filter more info

Use this filter to modify the complete form markup.

Digging Deeper
The form markup is passed as a string and expects a string response. This filter is commonly used to hide the form if a specific condition is not met.

called by GFFormDisplay::get_form() in form_display.php
gform_get_form_filter_{form_id} | filter more info

Form-specific version of the gform_get_form_filter filter. Example: gform_get_form_filter_1

Use this filter to modify the complete form markup.

Digging Deeper
The form markup is passed as a string and expects a string response. This filter is commonly used to hide the form if a specific condition is not met.

called by GFFormDisplay::get_form() in form_display.php
gform_shortcode_form | filter more info

Use this filter to modify the complete form markup.

Digging Deeper
This provides the same functionality as the gform_get_form_filter filter but is only applied when the form is loaded via the shortcode. For global modification of the generated form markup, use the gform_get_form_filter filter.

called by GFForms::parse_shortcode() in gravityforms.php

Hooks Run on Form Submission with Validation Error

toggle: Filters | Action

Form Submission Processing more info

The form submission process begins with WordPress' wp action. This action is triggered once WordPress is fully loaded and the WP object is setup (a.k.a. WordPress is ready to rock n' roll).

Gravity Forms binds the GFForms::maybe_process_form() method to the wp action. This method checks the submitted data to confirm that the submission is from a Gravity Forms form. If so, Gravity Forms will call the GFFormDisplay::process_form() method to begin processing the form submission.

gform_form_post_get_meta | filter more info

Use this filter to modify the form meta at the earliest possible point in the Gravity Forms form loading process. This filter will be applied once per form per page load as the form meta is cached until the next page load.

Digging Deeper
Note that this filter fires earlier on a form submission than on the intial form load. Typically this won't cause any issues but it is something to be aware of.

called by GFForms::maybe_process_form() in gravityforms.php
gform_form_post_get_meta_{form_id} | filter more info

Form-specific version of the gform_form_post_get_meta filter. Example: gform_form_post_get_meta_1

Use this filter to modify the form meta at the earliest possible point in the Gravity Forms form loading process. This filter will be applied once per form per page load as the form meta is cached until the next page load.

Digging Deeper
Note that this filter fires earlier on a form submission than on the intial form load. Typically this won't cause any issues but it is something to be aware of.

called by GFFormsModel::get_form_meta() in forms_model.php
gform_pre_process | action more info

Use this action to execute custom code prior to form submission being processed.

Digging Deeper
Gravity Forms has now processed some additional validation on the $form object to ensure that it should continue processing this submission. The form is not in the trash, the form is active and if the form requires a logged in user, this requirement is confirmed.

called by GFFormsDisplay::process_form() in form_display.php
gform_pre_process_{form_id} | action more info

Form-specific version of the gform_pre_process action. Example: gform_pre_process_1

Use this action to execute custom code prior to form submission being processed.

Digging Deeper
Gravity Forms has now processed some additional validation on the $form object to ensure that it should continue processing this submission. The form is not in the trash, the form is active and if the form requires a logged in user, this requirement is confirmed.

called by GFFormsDisplay::process_form() in form_display.php

Form Validation more info

Gravity Forms is ready to validate the submitted data based on the current $form object.

gform_pre_validation | filter more info

Use this filter to modify the $form object prior to Gravity Forms' default validation.

called by GFFormDisplay::validate() in form_display.php
gform_pre_validation_{form_id} | filter more info

Form-specific version of the gform_pre_validation filter. Example: gform_pre_validation_1

Use this filter to modify the $form object prior to Gravity Forms' default validation.

called by GFFormDisplay::validate() in form_display.php

Field Validation Loop more info

Gravity Forms is validating the submitted value for each field in the current form. The following hooks will be called for each field unless the field is hidden via conditional logic or is an Admin Only field.

gform_trim_input_value | filter more info

Use this filter to disable the removal of blank spaces at the beginning and end of field values. By default, all trailing and leading spaces will be removed.

called by GFFormsModel::maybe_trim_input() in forms_model.php
gform_field_validation | filter more info

Use this filter to override the validation per field. Gravity Forms will handle marking the submission as invalid if you return a validation error on any field.

called by GFFormDisplay::validate() in form_display.php
gform_field_validation_{form_id} | filter more info

Form-specific version of the gform_field_validation filter. Example: gform_field_validation_1

Use this filter to override the validation per field. Gravity Forms will handle marking the submission as invalid if you return a validation error on any field.

called by GFFormDisplay::validate() in form_display.php
gform_field_validation_{form_id}_{field_id} | filter more info

Field-specific version of the gform_field_validation filter. Example: gform_field_validation_1_2

Use this filter to override the validation per field. Gravity Forms will handle marking the submission as invalid if you return a validation error on any field.

called by GFFormDisplay::validate() in form_display.php

gform_validation | filter more info

Use this filter to override the submission validation as a whole.

Digging Deeper
If you are validating many fields or need a more generic validation method, this is the preferred hook for doing so. You can override the validation for each field as well as the final submisison validation result.

called by GFFormDisplay::validate() in form_display.php
gform_validation_{form_id} | filter more info

Form-specific version of the gform_validation filter. Example: gform_validation_1

Use this filter to override the submission validation as a whole.

Digging Deeper
If you are validating many fields or need a more generic validation method, this is the preferred hook for doing so. You can override the validation for each field as well as the final submisison validation result.

called by GFFormDisplay::validate() in form_display.php

gform_post_process | action more info

Use this action to excecute code after the form submission has been processed.

called by GFFormDisplay::process_form() in form_display.php
gform_post_process_{form_id} | action more info

Form-specific version of the gform_post_process action. Example: gform_post_process_1

Use this action to excecute code after the form submission has been processed.

called by GFFormDisplay::process_form() in form_display.php

Enqueue Scripts more info

Not much changes when enqueueing scripts for a form with a validation error. The enqueuing process still kicks off with WordPress' wp_enqueue_scripts action.

gform_pre_enqueue_scripts | action more info

Use this action to enqueue form scripts before Gravity Forms has enqueued it's own scripts.

Digging Deeper
Gravity Forms has retrieved the form meta and and is now ready to enqueue the neccesary scripts for the forms that have been found. GFFormDisplay::enqueue_form_scripts() will enqueue all form scripts (and styles) required by the current form. The enqueue_form_scripts() method will trigger the "gform_pre_enqueue_scripts" action before the Gravity Forms scripts have been enqueued.

called by GFFormsModel::enqueue_form_scripts() in form_display.php
gform_pre_enqueue_scripts_{form_id} | action more info

Form-specific version of the gform_pre_enqueue_scripts action. Example: gform_pre_enqueue_scripts_1

Use this action to enqueue form scripts before Gravity Forms has enqueued it's own scripts.

Digging Deeper
Gravity Forms has retrieved the form meta and and is now ready to enqueue the neccesary scripts for the forms that have been found. GFFormDisplay::enqueue_form_scripts() will enqueue all form scripts (and styles) required by the current form. The enqueue_form_scripts() method will trigger the "gform_pre_enqueue_scripts" action before the Gravity Forms scripts have been enqueued.

called by GFFormsModel::enqueue_form_scripts() in form_display.php
gform_has_conditional_logic | filter more info

Use this filter to override the GFFormDisplay::has_conditional_logic() check. If conditional logic has been enabled on the current form, this check will return true by default.

Digging Deeper
The GFFormDisplay::enqueue_form_scripts() method calls the GFFormDisplay::has_conditional_logic() method to determine whether or not to load Gravity Forms' conditional logic script (conditional_logic.js). The has_conditional_logic() method applys the "gform_has_conditional_logic" filter to allow overriding this check.

This is most commonly used to enable conditional logic on forms with custom-coded conditional logic support rather than disabling conditional logic on forms that are using Gravity Forms' default conditional logic.

called by GFFormDisplay::has_conditional_logic() in form_display.php
gform_has_conditional_logic | filter more info

Use this filter to override the GFFormDisplay::has_conditional_logic() check. If conditional logic has been enabled on the current form, this check will return true by default.

Digging Deeper
The GFFormDisplay::enqueue_form_scripts() method calls the GFFormDisplay::has_conditional_logic() method to determine whether or not to load Gravity Forms' conditional logic script (conditional_logic.js). The has_conditional_logic() method applys the "gform_has_conditional_logic" filter to allow overriding this check.

This is most commonly used to enable conditional logic on forms with custom-coded conditional logic support rather than disabling conditional logic on forms that are using Gravity Forms' default conditional logic.

called by GFFormDisplay::has_conditional_logic() in form_display.php
gform_enqueue_scripts | action more info

Use this action to enqueue form scripts after Gravity Forms has enqueued its own scripts. This is the preferred hook to use for enqueueing your own form scripts.

Digging Deeper
All form scripts for the current form have now been enqueued.

called by GFFormDisplay::enqueue_form_scripts() in form_display.php
gform_enqueue_scripts_{form_id} | action more info

Form-specific version of the gform_enqueue_scripts action. Example: gform_enqueue_scripts_1

Use this action to enqueue form scripts after Gravity Forms has enqueued its own scripts. This is the preferred hook to use for enqueueing your own form scripts.

Digging Deeper
All form scripts for the current form have now been enqueued.

called by GFFormDisplay::enqueue_form_scripts() in form_display.php

Form Markup more info

gform_form_args | filter more info

Use this filter to override the default arguments that will be used to render the form (i.e. "id", "display_title", "display_description", "ajax", "tabindex", etc). These arguments are specified in the shortcode or via the gravity_form() function.

Digging Deeper
The get_form() method applys this filter immediately allowing you to override form display argument before any form markup has been generated.

This would allow you to do things like enable AJAX for all forms or dynamically populate the form via the "field_values" argument.

called by GFFormDisplay::get_form() in form_display.php
gform_disable_view_counter | filter more info

Use this filter to prevent the current form load from counting as a form view.

Digging Deeper
This is useful in cases where you may be fetching the form markup via the GFFormDisplay::get_form() method (outside of the normal Gravity Forms form load flow) but not displaying it.

called by GFFormDisplay::get_form() in form_display.php
gform_disable_view_counter_{form_id} | filter more info

Form-specific version of the gform_disable_view_counter filter. Example: gform_disable_view_counter_1

Use this filter to prevent the current form load from counting as a form view.

Digging Deeper
This is useful in cases where you may be fetching the form markup via the GFFormDisplay::get_form() method (outside of the normal Gravity Forms form load flow) but not displaying it.

called by GFFormDisplay::get_form() in form_display.php
gform_pre_render | filter more info

Use this filter to modify the $form object before the form markup is generated.

Digging Deeper
Gravity Forms is about to generate the form markup. This is the preferred filter for modifying the $form object (including its $field objects) before the form markup is generated.

If you want to modify the markup for a field, use gform_field_input or gform_field_content.

called by GFFormDisplay::get_form() in form_display.php
gform_pre_render_{form_id} | filter more info

Form-specific version of the gform_pre_render filter. Example: gform_pre_render_1

Use this filter to modify the $form object before the form markup is generated.

Digging Deeper
Gravity Forms is about to generate the form markup. This is the preferred filter for modifying the $form object (including its $field objects) before the form markup is generated.

If you want to modify the markup for a field, use gform_field_input or gform_field_content.

called by GFFormDisplay::get_form() in form_display.php
gform_tabindex | filter more info

Use this filter to modify the tabindex start value (default is 0) or to disable the tabindex attribute.

Digging Deeper
For a helpful snippet on resolving most tabindex issues, see this.

called by GFFormDisplay::get_form() in form_display.php
gform_tabindex_{form_id} | filter more info

Form-specific version of the gform_tabindex filter. Example: gform_tabindex_1

Use this filter to modify the tabindex start value (default is 0) or to disable the tabindex attribute.

Digging Deeper
For a helpful snippet on resolving most tabindex issues, see this.

called by GFFormDisplay::get_form() in form_display.php
gform_pre_enqueue_scripts | action more info

Use this action to enqueue form scripts before Gravity Forms has enqueued it's own scripts.

Digging Deeper
Gravity Forms makes a second call to the GFFormDisplay::enqueue_form_scripts() method so that Gravity Forms scripts/styles are properly enqueued when the form is being loaded via the gravity_form() function call, rather than the shortcode.

If you're loading your form via the shortcode, you can ignore this. It won't cause you any issues.

called by GFFormsModel::enqueue_form_scripts() in form_display.php
gform_pre_enqueue_scripts_{form_id} | action more info

Form-specific version of the gform_pre_enqueue_scripts action. Example: gform_pre_enqueue_scripts_1

Use this action to enqueue form scripts before Gravity Forms has enqueued it's own scripts.

Digging Deeper
Gravity Forms makes a second call to the GFFormDisplay::enqueue_form_scripts() method so that Gravity Forms scripts/styles are properly enqueued when the form is being loaded via the gravity_form() function call, rather than the shortcode.

If you're loading your form via the shortcode, you can ignore this. It won't cause you any issues.

called by GFFormsModel::enqueue_form_scripts() in form_display.php
gform_has_conditional_logic | filter more info

Use this filter to override the GFFormDisplay::has_conditional_logic() check. If conditional logic has been enabled on the current form, this check will return true by default.

called by GFFormDisplay::has_conditional_logic() in form_display.php
gform_has_conditional_logic | filter more info

Use this filter to override the GFFormDisplay::has_conditional_logic() check. If conditional logic has been enabled on the current form, this check will return true by default.

called by GFFormDisplay::has_conditional_logic() in form_display.php
gform_enqueue_scripts | action more info

Use this action to enqueue form scripts after Gravity Forms has enqueued its own scripts. This is the preferred hook to use for enqueueing your own form scripts.

called by GFFormDisplay::enqueue_form_scripts() in form_display.php
gform_enqueue_scripts_{form_id} | action more info

Form-specific version of the gform_enqueue_scripts action. Example: gform_enqueue_scripts_1

Use this action to enqueue form scripts after Gravity Forms has enqueued its own scripts. This is the preferred hook to use for enqueueing your own form scripts.

called by GFFormDisplay::enqueue_form_scripts() in form_display.php
gform_is_form_editor | filter more info

Use this filter to override the GFCommon::is_form_editor() check.

Digging Deeper
Forms are displayed differently depending on the location in which they are loaded.

This filter is applied by the GFCommon::is_form_editor() method. The GFFormDisplay::get_form() method calls the is_form_editor() method to determine if the form is being loaded in the form editor. By default, this will return false if loading the form on the frontend.

called by GFCommon::is_form_editor() in common.php
gform_is_entry_detail | filter more info

Use this filter to override the GFCommon::is_entry_detail() check.

Digging Deeper
Forms are displayed differently depending on the location in which they are loaded.

This filter is applied by the GFCommon::is_entry_detail() method. The GFFormDisplay::get_form() method calls the is_entry_detail() method to determine if the form is being loaded in the entry detail view. By default, this will return false if loading the form on the frontend.

called by GFCommon::is_entry_detail() in common.php
gform_has_conditional_logic | filter more info

Use this filter to override the GFFormDisplay::has_conditional_logic() check. If conditional logic has been enabled on the current form, this check will return true by default.

called by GFFormDisplay::has_conditional_logic() in form_display.php
gform_confirmation_anchor | filter more info

Use this filter to enable or disable the confirmation anchor functionality.

Digging Deeper
When enabled, Gravity Forms will automatically scroll the page to the confirmation message upon submission. Provide a numeric value (in pixels) to force the page to scroll to a specified distance from the top of the page. This is useful when embedding forms in a long page.

called by GFFormDisplay::get_form() in form_display.php
gform_confirmation_anchor_{form_id} | filter more info

Form-specific version of the gform_confirmation_anchor filter. Example: gform_confirmation_anchor_1

Use this filter to enable or disable the confirmation anchor functionality.

Digging Deeper
When enabled, Gravity Forms will automatically scroll the page to the confirmation message upon submission. Provide a numeric value (in pixels) to force the page to scroll to a specified distance from the top of the page. This is useful when embedding forms in a long page.

called by GFFormDisplay::get_form() in form_display.php
gform_form_tag | filter more info

Use this filter to modify the markup of the <form> HTML tag.

called by GFFormDisplay::get_form() in form_display.php
gform_form_tag_{form_id} | filter more info

Form-specific version of the gform_form_tag filter. Example: gform_form_tag_1

Use this filter to modify the markup of the <form> HTML tag.

called by GFFormDisplay::get_form() in form_display.php
gform_validation_message | filter more info

Use this filter to modify the validation message that displays at the top of the form. By default, this validation message does not list specific validation errors but indicates that there are errors on the form.

called by GFFormDisplay::get_form() in form_display.php
gform_validation_message_{form_id} | filter more info

Form-specific version of the gform_validation_message filter. Example: gform_validation_message_1

Use this filter to modify the validation message that displays at the top of the form. By default, this validation message does not list specific validation errors but indicates that there are errors on the form.

called by GFFormDisplay::get_form() in form_display.php

Field Markup

gform_trim_input_value | filter more info

Use this filter to disable the removal of blank spaces at the beginning and end of field values. By default, all trailing and leading spaces will be removed.

Digging Deeper
Since the form has been submitted, Gravity Forms will repopulate submitted values back into their respective fields. The submitted field value is retrieved via the GFFormsModel::get_field_value() method. This starts a chain that will eventually call the GFFormsModel::maybe_trim_input_value() method which applies this filter.

called by GFFormsModel::maybe_trim_input() in forms_model.php
gform_is_form_editor | filter more info

Use this filter to override the GFCommon::is_form_editor() check.

Digging Deeper
Fields are displayed differently in the form editor than on the frontend. Gravity Forms needs to know where we are displaying the field. If the form is being loaded on the frontend, this filter will be return false by default.

Note: this filter is called repeatedly throughout the field markup loop. The remaining calls are not listed here.

called by GFCommon::is_form_editor() in common.php
gform_is_entry_detail | filter more info

Use this filter to override the GFCommon::is_entry_detail() check.

Digging Deeper
Fields are displayed differently in the entry detail than on the frontend. Gravity Forms needs to know where we are displaying the field. If the form is being loaded on the frontend, this filter will be return false by default.

Note: this filter is called repeatedly throughout the field markup loop. The remaining calls are not listed here.

called by GFCommon::is_entry_detail() in common.php
gform_field_css_class | filter more info

Use this filter to add or remove CSS classes for the current field.

called by GFFormDisplay::get_field() in form_display.php
gform_field_css_class_{form_id} | filter more info

Form-specific version of the gform_field_css_class filter. Example: gform_field_css_class_1

Use this filter to add or remove CSS classes for the current field.

called by GFFormDisplay::get_field() in form_display.php
gform_duplicate_field_link | filter more info

Digging Deeper
Ignore. This filter is used when viewing the form in the form editor and probably should not be applied when the form is loaded on the frontend.

called by in
gform_delete_field_link | filter more info

Digging Deeper
Ignore. This filter is used when viewing the form in the form editor and probably should not be applied when the form is loaded on the frontend.

called by in
gform_replace_merge_tags | filter more info

Use this filter to replace custom merge tags.

Digging Deeper
This instance of the filter is replacing merge tags populated into the Default Value setting of the current field.

called by GFCommon::replace_variables_prepopulate() in common.php
gform_field_input | filter more info

Use this filter to generate custom markup for the current field's input(s).

Digging Deeper
At the time this filter is called, the input markup has not yet been generated. This filter passes an empty string. If you return anything other than an empty string, it will be used instead of the default input markup.

called by GFCommon::get_field_input() in common.php
gform_replace_merge_tags | filter more info

Use this filter to replace custom merge tags.

Digging Deeper
This instance of the filter is replacing merge tags populated into the Placeholder setting of the current input of the current field.

called by GFCommon::replace_variables() in common.php
gform_field_content | filter more info

Use this filter to modify the label and input markup of the current field.

Digging Deeper
If the field has multiple inputs, all labels and inputs will be present. This filter differs from the gform_field_input filter in that it passes the default markup which can be modified and returned.

called by GFFormDisplay::get_field_content() in form_display.php
gform_field_container | filter more info

Use this filter to modify the complete markup of the current field. This includes the <li> container that wraps each field.

called by GFFormDisplay::get_field() in form_display.php
gform_field_container_{form_id} | filter more info

Form-specific version of the gform_field_container filter. Example: gform_field_container_1

Use this filter to modify the complete markup of the current field. This includes the <li> container that wraps each field.

called by GFFormDisplay::get_field() in form_display.php
gform_field_container_{form_id}_{field_id} | filter more info

Field-specific version of the gform_field_container filter. Example: gform_field_container_1_2

Use this filter to modify the complete markup of the current field. This includes the <li> container that wraps each field.

called by GFFormDisplay::get_field() in form_display.php

gform_submit_button | filter more info

Use this filter to modify the current form's submit button.

Digging Deeper
This filter is commonly used to convert the submit button from an <input type="submit" /> to an actual <button>. This allows the use of HTML inside the button for general fanciness.

called by GFFormDisplay::gform_footer() in form_display.php
gform_submit_button_{form_id} | filter more info

Form-specific version of the gform_submit_button filter. Example: gform_submit_button_1

Use this filter to modify the current form's submit button.

Digging Deeper
This filter is commonly used to convert the submit button from an <input type="submit" /> to an actual <button>. This allows the use of HTML inside the button for general fanciness.

called by GFFormDisplay::gform_footer() in form_display.php
gform_has_conditional_logic | filter more info

Use this filter to override the GFFormDisplay::has_conditional_logic() check. If conditional logic has been enabled on the current form, this check will return true by default.

Digging Deeper
This specific check is to determine whether or not the conditional logic initialization script should be loaded.

called by GFFormDisplay::has_conditional_logic() in form_display.php
gform_register_init_scripts | action more info

Use this action to register your own init scripts.

Digging Deeper
Init scripts are inline JS scripts that are output along with the form markup and trigger the necessary JS functionality when the form is fully loaded.

called by GFFormDisplay::register_form_init_scripts() in form_display.php
gform_register_init_scripts_{form_id} | action more info

Form-specific version of the gform_register_init_scripts action. Example: gform_register_init_scripts_1

Use this action to register your own init scripts.

Digging Deeper
Init scripts are inline JS scripts that are output along with the form markup and trigger the necessary JS functionality when the form is fully loaded.

called by GFFormDisplay::register_form_init_scripts() in form_display.php
gform_init_scripts_footer | filter more info

Use this filter to output Gravity Forms' init scripts in the footer rather than along with the form markup.

Digging Deeper
This is useful when a script file required by an init script is ouput in the footer rather than the header. For example, if you wanted to load jQuery in the footer, you would need to set this to true so that the init scripts (which depend on jQuery) would load after jQuery has been loaded.

called by GFFormDisplay::get_form() in form_display.php
gform_cdata_open | filter more info

Use this filter to wrap Gravity Forms' inline scripts in CDATA tags.

Digging Deeper
This is required for valid XHTML. Most themes use HTML5 now which does not require CDATA tags for validation.

called by GFFormDisplay::get_form() in form_display.php
gform_cdata_close | filter more info

Use this filter to wrap Gravity Forms' inline scripts in CDATA tags.

Digging Deeper
This is required for valid XHTML. Most themes use HTML5 now which does not require CDATA tags for validation.

called by GFFormDisplay::get_form() in form_display.php
gform_get_form_filter | filter more info

Use this filter to modify the complete form markup.

Digging Deeper
The form markup is passed as a string and expects a string response. This filter is commonly used to hide the form if a specific condition is not met.

called by GFFormDisplay::get_form() in form_display.php
gform_get_form_filter_{form_id} | filter more info

Form-specific version of the gform_get_form_filter filter. Example: gform_get_form_filter_1

Use this filter to modify the complete form markup.

Digging Deeper
The form markup is passed as a string and expects a string response. This filter is commonly used to hide the form if a specific condition is not met.

called by GFFormDisplay::get_form() in form_display.php
gform_shortcode_form | filter more info

Use this filter to modify the complete form markup.

Digging Deeper
This provides the same functionality as the gform_get_form_filter filter but is only applied when the form is loaded via the shortcode. For global modification of the generated form markup, use the gform_get_form_filter filter.

called by GFForms::parse_shortcode() in gravityforms.php

Hooks Run on Successful Form Submission

This scenario uses the default confirmation and the default notification.

toggle: Filters | Action

Form Submission Processing more info

The form submission process begins with WordPress' wp action. This action is triggered once WordPress is fully loaded and the WP object is setup (a.k.a. WordPress is ready to rock n' roll).

gform_form_post_get_meta | filter more info

Use this filter to modify the form meta at the earliest possible point in the Gravity Forms form loading process. This filter will be applied once per form per page load as the form meta is cached until the next page load.

Digging Deeper
Note that this filter fires earlier on a form submission than on the intial form load. Typically this won't cause any issues but it is something to be aware of.

called by GFFormsModel::get_form_meta() in forms_model.php
gform_form_post_get_meta_{form_id} | filter more info

Form-specific version of the gform_form_post_get_meta filter. Example: gform_form_post_get_meta_1

Use this filter to modify the form meta at the earliest possible point in the Gravity Forms form loading process. This filter will be applied once per form per page load as the form meta is cached until the next page load.

Digging Deeper
Note that this filter fires earlier on a form submission than on the intial form load. Typically this won't cause any issues but it is something to be aware of.

called by GFFormsModel::get_form_meta() in forms_model.php
gform_pre_process | action more info

Use this action to execute custom code prior to form submission being processed.

Digging Deeper
Gravity Forms has now processed some additional validation on the $form object to ensure that it should continue processing this submission. The form is not in the trash, the form is active and if the form requires a logged in user, this requirement is confirmed.

called by GFFormsDisplay::process_form() in form_display.php
gform_pre_process_{form_id} | action more info

Form-specific version of the gform_pre_process action. Example: gform_pre_process_1

Use this action to execute custom code prior to form submission being processed.

Digging Deeper
Gravity Forms has now processed some additional validation on the $form object to ensure that it should continue processing this submission. The form is not in the trash, the form is active and if the form requires a logged in user, this requirement is confirmed.

called by GFFormsDisplay::process_form() in form_display.php

Form Validation more info

Gravity Forms is ready to validate the submitted data based on the current $form object.

gform_pre_validation | filter more info

Use this filter to modify the $form object prior to Gravity Forms' default validation.

called by GFFormDisplay::validate() in form_display.php
gform_pre_validation_{form_id} | filter more info

Form-specific version of the gform_pre_validation filter. Example: gform_pre_validation_1

Use this filter to modify the $form object prior to Gravity Forms' default validation.

called by GFFormDisplay::validate() in form_display.php

Field Validation Loop more info

gform_trim_input_value | filter more info

Use this filter to disable the removal of blank spaces at the beginning and end of field values. By default, all trailing and leading spaces will be removed.

called by GFFormsModel::maybe_trim_input() in forms_model.php
gform_field_validation | filter more info

Use this filter to override the validation per field. Gravity Forms will handle marking the submission as invalid if you return a validation error on any field.

called by GFFormDisplay::validate() in form_display.php
gform_field_validation_{form_id} | filter more info

Form-specific version of the gform_field_validation filter. Example: gform_field_validation_1

Use this filter to override the validation per field. Gravity Forms will handle marking the submission as invalid if you return a validation error on any field.

called by GFFormDisplay::validate() in form_display.php
gform_field_validation_{form_id}_{field_id} | filter more info

Field-specific version of the gform_field_validation filter. Example: gform_field_validation_1_2

Use this filter to override the validation per field. Gravity Forms will handle marking the submission as invalid if you return a validation error on any field.

called by GFFormDisplay::validate() in form_display.php

gform_validation | filter more info

Use this filter to override the submission validation as a whole.

Digging Deeper
If you are validating many fields or need a more generic validation method, this is the preferred hook for doing so. You can override the validation for each field as well as the final submisison validation result.

called by GFFormDisplay::validate() in form_display.php
gform_validation_{form_id} | filter more info

Form-specific version of the gform_validation filter. Example: gform_validation_1

Use this filter to override the submission validation as a whole.

Digging Deeper
If you are validating many fields or need a more generic validation method, this is the preferred hook for doing so. You can override the validation for each field as well as the final submisison validation result.

called by GFFormDisplay::validate() in form_display.php

gform_pre_submission | action more info

Use this action to excecute code after the submission has been successfully validated and before the submission is saved as an entry in the database.

Digging Deeper
This action will only be triggered if the submission has been validated successfully. A form submission that results in a validation error is technically still a submission; however, this filter refers to valid submissions only.

called by GFFormDisplay::process_form() in form_display.php
gform_pre_submission_{form_id} | action more info

Form-specific version of the gform_pre_submission action. Example: gform_pre_submission_1

Use this action to excecute code after the submission has been successfully validated and before the submission is saved as an entry in the database.

Digging Deeper
This action will only be triggered if the submission has been validated successfully. A form submission that results in a validation error is technically still a submission; however, this filter refers to valid submissions only.

called by GFFormDisplay::process_form() in form_display.php
gform_pre_submission_filter | filter more info

Use this filter to modify the $form object after the submission has been successfully validated and before the submission is saved as an entry in the database.

Digging Deeper
Like the gform_pre_submission action, this filter will only be triggered when the submission has been validated successfully.

This filter is commonly use in combination with the gform_pre_render hook so that modifications made to the $form object for rendering also apply to the $form object used for submission.

called by GFFormDisplay::process_form() in form_display.php
gform_pre_submission_filter_{form_id} | filter more info

Form-specific version of the gform_pre_submission_filter filter. Example: gform_pre_submission_filter_1

Use this filter to modify the $form object after the submission has been successfully validated and before the submission is saved as an entry in the database.

Digging Deeper
Like the gform_pre_submission action, this filter will only be triggered when the submission has been validated successfully.

This filter is commonly use in combination with the gform_pre_render hook so that modifications made to the $form object for rendering also apply to the $form object used for submission.

called by GFFormDisplay::process_form() in form_display.php

Saving Entry more info

Great news! The submission has been successfully validated. Gravity Forms is going to save the submission as an $entry object in the database.

gform_entry_id_pre_save_lead | filter more info

Use this filter to modify the entry ID before the entry is saved.

Digging Deeper
This hook allows you to update an existing entry rather than creating a new entry. Just return the entry ID of the existing entry and the submitted values will be used to update the entry. By default, the entry ID will be null.

If an entry ID is provided, the associated $entry object will be used throughout the rest of the submission process.

called by GFFormDisplay::handle_submission() in form_display.php
gform_entry_id_pre_save_lead_{form_id} | filter more info

Form-specific version of the gform_entry_id_pre_save_lead filter. Example: gform_entry_id_pre_save_lead_1

Use this filter to modify the entry ID before the entry is saved.

Digging Deeper
This hook allows you to update an existing entry rather than creating a new entry. Just return the entry ID of the existing entry and the submitted values will be used to update the entry. By default, the entry ID will be null.

If an entry ID is provided, the associated $entry object will be used throughout the rest of the submission process.

called by GFFormDisplay::handle_submission() in form_display.php
gform_is_form_editor | filter more info

Use this filter to override the GFCommon::is_form_editor() check.

Digging Deeper
Gravity Forms calls the GFCommon::is_form_editor() and the GFCommon::is_entry_detail() methods to determine if the $entry is being saved from within the WordPress admin. If so, it also confirms that the user has the correct permissions to edit entries.

called by GFCommon::is_form_editor() in common.php
gform_is_entry_detail | filter more info

Use this filter to override the GFCommon::is_entry_detail() check.

Digging Deeper
Gravity Forms calls the GFCommon::is_form_editor() and the GFCommon::is_entry_detail() methods to determine if the $entry is being saved from within the WordPress admin. If so, it also confirms that the user has the correct permissions to edit entries.

called by GFCommon::is_entry_detail() in common.php
gform_currency | filter more info

Use this filter to change the currency. This will default to the currency configured on the Gravity Forms settings page.

called by GFCommon::get_currency() in forms_model.php

Saving Fields more info

The basic entry details have been saved to the database (e.g. "form_id", "ip", "source_url", "date_created", "user_agent", "currency", "created_by"). Gravity Forms will now loop through each field (and each input for multi-input fields) and save them individually to entry. All of these hooks are originate from the GFFormsModel::save_input() method.

gform_trim_input_value | filter more info

Use this filter to disable the removal of blank spaces at the beginning and end of field values. By default, all trailing and leading spaces will be removed.

called by GFFormsModel::maybe_trim_input() in forms_model.php
gform_is_form_editor | filter more info

Use this filter to override the GFCommon::is_form_editor() check.

called by GFCommon::is_form_editor() in common.php
gform_is_entry_detail | filter more info

Use this filter to override the GFCommon::is_entry_detail() check.

called by GFCommon::is_entry_detail() in common.php
gform_allowable_tags | filter more info

Use this filter to enable HTML or specify accepted HTML tags in submitted entry data.

Digging Deeper
Most fields will have HTML disabled by default. This filter is most often used to allow specific HTML tags in specific fields (i.e. Paragraph Text field). Be wary of enabling HTML unconditionally unless you know what you're doing.

called by GFField::sanitize_entry_value() in /includes/fields/class-gf-field.php
gform_allowable_tags_{form_id} | filter more info

Form-specific version of the gform_allowable_tags filter. Example: gform_allowable_tags_1

Use this filter to enable HTML or specify accepted HTML tags in submitted entry data.

Digging Deeper
Most fields will have HTML disabled by default. This filter is most often used to allow specific HTML tags in specific fields (i.e. Paragraph Text field). Be wary of enabling HTML unconditionally unless you know what you're doing.

called by GFField::sanitize_entry_value() in /includes/fields/class-gf-field.php
gform_save_field_value | filter more info

Use this filter to modify the field value before it is saved to the database.

Digging Deeper
This filter can be used in conjunction with gform_get_input_value to allow you to store the value in the database in one format but retrieve it another (i.e. encrypt/decrypt).

called by GFFormsModel::get_prepared_input_value() in forms_model.php

gform_get_input_value | filter more info

Use this filter to modify the field value after it has been retrieved from the database.

Digging Deeper
This filter can be used in conjunction with gform_save_input_value to allow you to store the value in the database in one format but retrieve it another (i.e. encrypt/decrypt).

Note: this filter will be called for each input of each field on your form.

called by GFFormsModel::build_lead_array() in forms_model.php
gform_entry_meta | filter more info

Use this filter to add custom properties (a.k.a "meta") to the $entry object.

Digging Deeper
Entry meta data can be added as sortable columns to the entry list and export entries file.

called by GFFormsModel::get_entry_meta() in forms_model.php
gform_entry_is_spam | filter more info

Use this filter to modify whether the current entry is considered spam.

Digging Deeper
Gravity Forms will only mark an entry as spam if Akismet is enabled, the "Akismet Integration" setting has not been disabled, and Akismet has indicated the entry is spam. This filter will allow you to override Akismet's assessment.

This hook would also be the ideal access point to provide your own custom spam protection or integrate with another 3rd party spam protection service.

called by GFFormDisplay::handle_submission() in form_display.php
gform_entry_is_spam_{form_id} | filter more info

Form-specific version of the gform_entry_is_spam filter. Example: gform_entry_is_spam_1

Use this filter to modify whether the current entry is considered spam.

Digging Deeper
Gravity Forms will only mark an entry as spam if Akismet is enabled, the "Akismet Integration" setting has not been disabled, and Akismet has indicated the entry is spam. This filter will allow you to override Akismet's assessment.

This hook would also be the ideal access point to provide your own custom spam protection or integrate with another 3rd party spam protection service.

called by GFFormDisplay::handle_submission() in form_display.php
gform_entry_created | action more info

Use this action to execute code after the entry has been created.

Digging Deeper
Note: this filter is applied before the post has been created, notifications have been sent and the confirmation has been processed. If you need to modify the $entry object](https://www.gravityhelp.com/documentation/article/entry-object/), use the [gform_entry_post_save filter.

called by GFFormDisplay::handle_submission() in form_display.php
gform_entry_post_save | filter more info

Use this filter to modify the entry after it has been saved to the database.

called by GFFormDisplay::handle_submission() in form_display.php
gform_entry_post_save_{form_id} | filter more info

Form-specific version of the gform_entry_post_save filter. Example: gform_entry_post_save_1

Use this filter to modify the entry after it has been saved to the database.

called by GFFormDisplay::handle_submission() in form_display.php
gform_disable_post_creation | filter more info

Use this filter to disable post creation for GF.

Digging Deeper
This filter is only applicable if the form contains a Post Field. If you return true and the form does not contain a Post Field, Gravity Forms will still abandon the post creation process.

called by GFCommon::create_post() in common.php
gform_disable_post_creation_{form_id} | filter more info

Form-specific version of the gform_disable_post_creation filter. Example: gform_disable_post_creation_1

Use this filter to disable post creation for GF.

Digging Deeper
This filter is only applicable if the form contains a Post Field. If you return true and the form does not contain a Post Field, Gravity Forms will still abandon the post creation process.

called by GFCommon::create_post() in common.php

Sending Form Notifications more info

The entry has been created and saved to the database. Now Gravity Forms is ready to send notifications.

gform_disable_notification | filter more info

Use this filter to disable all or specific notifications.

Digging Deeper
This filter is applied for each notification to be sent. The current $notification object is passed for each filter call.

called by GFAPI::send_notifications() in /includes/api.php
gform_disable_notification_{form_id} | filter more info

Form-specific version of the gform_disable_notification filter. Example: gform_disable_notification_1

Use this filter to disable all or specific notifications.

Digging Deeper
This filter is applied for each notification to be sent. The current $notification object is passed for each filter call.

called by GFAPI::send_notifications() in /includes/api.php
gform_notification | filter more info

Use this filter to modify a $notification object before it is converted to an email and sent.

Digging Deeper
This is the go-to filter for modify notifications. It gives you complete access to the $notification object so you can make all sorts of changes and still allow Gravity Forms to handle much of the heavy lifting.

called by GFCommon::send_notification() in common.php
gform_notification_{form_id} | filter more info

Form-specific version of the gform_notification filter. Example: gform_notification_1

Use this filter to modify a $notification object before it is converted to an email and sent.

Digging Deeper
This is the go-to filter for modify notifications. It gives you complete access to the $notification object so you can make all sorts of changes and still allow Gravity Forms to handle much of the heavy lifting.

called by GFCommon::send_notification() in common.php
gform_pre_replace_merge_tags | filter more info

Use this filter to replace default Gravity Forms merge tags before they are replaced by GF.

Digging Deeper
GFCommon::replace_variables() is being called now to process the "to", "subject", "from", "from_name", "bcc, "replyTo", and "message" notification properties. This filter is called once for each property via the GFCommon::replace_variables() method.

called by GFCommon::replace_variables() in common.php
gform_replace_merge_tags | filter more info

Use this filter to replace custom merge tags.

Digging Deeper
GFCommon::replace_variables() is being called now to process the "to", "subject", "from", "from_name", "bcc, "replyTo", and "message" notification properties. This filter is called once for each property via the GFCommon::replace_variables_prepopulate() method.

called by GFCommon::replace_variables_prepopulate() in common.php
gform_replace_merge_tags | filter more info

Use this filter to replace custom merge tags.

Digging Deeper
GFCommon::replace_variables() is being called now to process the "to", "subject", "from", "from_name", "bcc, "replyTo", and "message" notification properties. This filter is called once for each property via the GFCommon::replace_variables() method.

called by GFCommon::replace_variables_prepopulate() in common.php

{all_fields} more info

Since the {all_fields} merge tag is the most popular Gravity Forms merge tag, I wanted to cover its usage in notifications. At this point, Gravity Forms is processing the "message" property of the current notification. The default notification contains the {all_fields} merge tag.

Note: the gform_replace_merge_tags filter is called after the {all_fields} markup has been generated. It is excluded here for the sake of orginzation.

gform_get_field_value | filter more info

called by GFFormsModel::get_lead_field_value() in forms_model.php
gform_merge_tag_filter | filter more info

Use this filter to modify the output of default Gravity Forms merge tags.

Digging Deeper
This filter's purpose differs from gform_replace_merge_tags in that it allows you to modify (or completely replace) the generated value of default Gravity Forms merge tags. The addition of the gform_pre_replace_merge_tags filter allows you to now replace default Gravity Forms merge tags; however, this filter is still the preferred method for doing so. It will provide field-specific data based on the merge tag being replaced, including the {all_fields} merge tag.

called by in
gform_email_background_color_label | filter more info

Use this filter to modify the background color of the "label" row in the table markup generated by the {all_fields} merge tag.

called by in
gform_email_background_color_data | filter more info

Use this filter to modify the background color of the "data" row (a.k.a. "field value") in the table markup generated by the {all_fields} merge tag.

called by in

gform_enable_shortcode_notification_message | filter more info

Use this filter to enable or disable the usage of shortcodes in the notification message.

Digging Deeper
By default, Gravity Forms will parse shortcodes in the notification message.

called by GFCommon::send_notification() in common.php
gform_pre_send_email | filter more info

Use this filter to modify (or disable) an email before it is sent.

Digging Deeper
This filter gives low-level access all notification emails before they are sent. The email object represents the exact data that will be used to send the email, while the $notification object is the template on which the email is based.

You can abort any Gravity Forms email by setting $email['abort_email'] to true and returning the modified $email object.

called by GFCommon::send_email() in common.php
gform_after_email | action more info

Use this action to excecute code after a Gravity Forms email has been sent.

called by GFCommon::send_email() in common.php

Loading Confirmation

gform_confirmation_anchor | filter more info

Use this filter to enable or disable the confirmation anchor functionality.

Digging Deeper
By default, the confirmation anchor is disabled unless the form has multiple pages.

The most common need for this filter is when loading a single-page Gravity Forms form lower on the page. The user submits the form and is taken to the top of the page, unable to see the confirmation without scrolling. If you return true with this filter, the page would automatically scroll to the confirmation message when the form is submitted.

called by GFFormDisplay::handle_confirmation() in form_display.php
gform_confirmation_anchor_{form_id} | filter more info

Form-specific version of the gform_confirmation_anchor filter. Example: gform_confirmation_anchor_1

Use this filter to enable or disable the confirmation anchor functionality.

Digging Deeper
By default, the confirmation anchor is disabled unless the form has multiple pages.

The most common need for this filter is when loading a single-page Gravity Forms form lower on the page. The user submits the form and is taken to the top of the page, unable to see the confirmation without scrolling. If you return true with this filter, the page would automatically scroll to the confirmation message when the form is submitted.

called by GFFormDisplay::get_form() in form_display.php
gform_pre_replace_merge_tags | filter more info

Use this filter to replace default Gravity Forms merge tags before they are replaced by GF.

Digging Deeper
This instance this filter is being called while replacing merge tags in the confirmation message, page, or redirect URL (depending on the confirmation settings you have configured).

called by GFCommon::replace_variables() in common.php
gform_replace_merge_tags | filter more info

Use this filter to replace custom merge tags.

called by GFCommon::replace_variables_prepopulate() in common.php
gform_replace_merge_tags | filter more info

Use this filter to replace custom merge tags.

called by GFCommon::replace_variables_prepopulate() in common.php
gform_confirmation | filter more info

Use this filter to modify the confirmation message or redirect URL.

Digging Deeper
Note: this filter does not allow you to modify the $confirmation object. If the confirmation type is "text", it will pass the parsed confirmation message. If the confirmation type is "page" or "redirect", it will pass the URL to which the user will be redirected. In both cases, merge tags will already be replaced in the passed value.

See the full documentation (click the hook name for link) for more information on expected return values.

called by GFFormDisplay::handle_confirmation() in form_display.php
gform_confirmation_{form_id} | filter more info

Form-specific version of the gform_confirmation filter. Example: gform_confirmation_1

Use this filter to modify the confirmation message or redirect URL.

Digging Deeper
Note: this filter does not allow you to modify the $confirmation object. If the confirmation type is "text", it will pass the parsed confirmation message. If the confirmation type is "page" or "redirect", it will pass the URL to which the user will be redirected. In both cases, merge tags will already be replaced in the passed value.

See the full documentation (click the hook name for link) for more information on expected return values.

called by GFFormDisplay::handle_confirmation() in form_display.php

gform_after_submission | action more info

Use this action to execute code after the submission has been successfully processed.

Digging Deeper
This action is only triggered if the form submission is successfully. Form submission with validation errors will not trigger this action.

called by GFFormDisplay::process_form() in form_display.php
gform_after_submission_{form_id} | action more info

Form-specific version of the gform_after_submission action. Example: gform_after_submission_1

Use this action to execute code after the submission has been successfully processed.

Digging Deeper
This action is only triggered if the form submission is successfully. Form submission with validation errors will not trigger this action.

called by GFFormDisplay::process_form() in form_display.php
gform_post_process | action more info

Use this action to excecute code after the form submission has been processed.

Digging Deeper
This action will fire on every form submission even if the submission returns a validation error. If you only want to execute code on successful submissions, use gform_after_submission.

called by GFFormDisplay::process_form() in form_display.php
gform_post_process_{form_id} | action more info

Form-specific version of the gform_post_process action. Example: gform_post_process_1

Use this action to excecute code after the form submission has been processed.

Digging Deeper
This action will fire on every form submission even if the submission returns a validation error. If you only want to execute code on successful submissions, use gform_after_submission.

called by GFFormDisplay::process_form() in form_display.php

Enqueue Scripts more info

It all begins with WordPress' wp_enqueue_scripts action.

gform_pre_enqueue_scripts | action more info

Use this action to enqueue form scripts before Gravity Forms has enqueued it's own scripts.

Digging Deeper
Gravity Forms has retrieved the form meta and and is now ready to enqueue the neccesary scripts for the forms that have been found. GFFormDisplay::enqueue_form_scripts() will enqueue all form scripts (and styles) required by the current form. The enqueue_form_scripts() method will trigger the "gform_pre_enqueue_scripts" action before the Gravity Forms scripts have been enqueued.

called by GFFormsModel::enqueue_form_scripts() in form_display.php
gform_pre_enqueue_scripts_{form_id} | action more info

Form-specific version of the gform_pre_enqueue_scripts action. Example: gform_pre_enqueue_scripts_1

Use this action to enqueue form scripts before Gravity Forms has enqueued it's own scripts.

Digging Deeper
Gravity Forms has retrieved the form meta and and is now ready to enqueue the neccesary scripts for the forms that have been found. GFFormDisplay::enqueue_form_scripts() will enqueue all form scripts (and styles) required by the current form. The enqueue_form_scripts() method will trigger the "gform_pre_enqueue_scripts" action before the Gravity Forms scripts have been enqueued.

called by GFFormsModel::enqueue_form_scripts() in form_display.php
gform_has_conditional_logic | filter more info

Use this filter to override the GFFormDisplay::has_conditional_logic() check. If conditional logic has been enabled on the current form, this check will return true by default.

Digging Deeper
The GFFormDisplay::enqueue_form_scripts() method calls the GFFormDisplay::has_conditional_logic() method to determine whether or not to load Gravity Forms' conditional logic script (conditional_logic.js). The has_conditional_logic() method applys the "gform_has_conditional_logic" filter to allow overriding this check.

This is most commonly used to enable conditional logic on forms with custom-coded conditional logic support rather than disabling conditional logic on forms that are using Gravity Forms' default conditional logic.

called by GFFormDisplay::has_conditional_logic() in form_display.php
gform_has_conditional_logic | filter more info

Use this filter to override the GFFormDisplay::has_conditional_logic() check. If conditional logic has been enabled on the current form, this check will return true by default.

Digging Deeper
The GFFormDisplay::enqueue_form_scripts() method calls the GFFormDisplay::has_conditional_logic() method to determine whether or not to load Gravity Forms' conditional logic script (conditional_logic.js). The has_conditional_logic() method applys the "gform_has_conditional_logic" filter to allow overriding this check.

This is most commonly used to enable conditional logic on forms with custom-coded conditional logic support rather than disabling conditional logic on forms that are using Gravity Forms' default conditional logic.

called by GFFormDisplay::has_conditional_logic() in form_display.php
gform_enqueue_scripts | action more info

Use this action to enqueue form scripts after Gravity Forms has enqueued its own scripts. This is the preferred hook to use for enqueueing your own form scripts.

Digging Deeper
All form scripts for the current form have now been enqueued.

called by GFFormDisplay::enqueue_form_scripts() in form_display.php
gform_enqueue_scripts_{form_id} | action more info

Form-specific version of the gform_enqueue_scripts action. Example: gform_enqueue_scripts_1

Use this action to enqueue form scripts after Gravity Forms has enqueued its own scripts. This is the preferred hook to use for enqueueing your own form scripts.

Digging Deeper
All form scripts for the current form have now been enqueued.

called by GFFormDisplay::enqueue_form_scripts() in form_display.php

Form Markup more info

Gravity Forms is ready to render the form markup. The markup for a successful submission is dictated by the confirmation. The following hooks will be executed only for a "Text"-type confirmation. Page and Rediect URL confirmations will simply redirect to the designated URL.

gform_form_args | filter more info

Use this filter to override the default arguments that will be used to render the form (i.e. "id", "display_title", "display_description", "ajax", "tabindex", etc). These arguments are specified in the shortcode or via the gravity_form() function.

Digging Deeper
The get_form() method applys this filter immediately allowing you to override form display argument before any form markup has been generated.

This would allow you to do things like enable AJAX for all forms or dynamically populate the form via the "field_values" argument.

called by GFFormDisplay::get_form() in form_display.php
gform_disable_view_counter | filter more info

Use this filter to prevent the current form load from counting as a form view.

Digging Deeper
This is useful in cases where you may be fetching the form markup via the GFFormDisplay::get_form() method (outside of the normal Gravity Forms form load flow) but not displaying it.

called by GFFormDisplay::get_form() in form_display.php
gform_disable_view_counter_{form_id} | filter more info

Form-specific version of the gform_disable_view_counter filter. Example: gform_disable_view_counter_1

Use this filter to prevent the current form load from counting as a form view.

Digging Deeper
This is useful in cases where you may be fetching the form markup via the GFFormDisplay::get_form() method (outside of the normal Gravity Forms form load flow) but not displaying it.

called by GFFormDisplay::get_form() in form_display.php
gform_pre_render | filter more info

Use this filter to modify the $form object before the form markup is generated.

Digging Deeper
Gravity Forms is about to generate the form markup. This is the preferred filter for modifying the $form object (including its $field objects) before the form markup is generated.

If you want to modify the markup for a field, use gform_field_input or gform_field_content.

called by GFFormDisplay::get_form() in form_display.php
gform_pre_render_{form_id} | filter more info

Form-specific version of the gform_pre_render filter. Example: gform_pre_render_1

Use this filter to modify the $form object before the form markup is generated.

Digging Deeper
Gravity Forms is about to generate the form markup. This is the preferred filter for modifying the $form object (including its $field objects) before the form markup is generated.

If you want to modify the markup for a field, use gform_field_input or gform_field_content.

called by GFFormDisplay::get_form() in form_display.php
gform_tabindex | filter more info

Use this filter to modify the tabindex start value (default is 0) or to disable the tabindex attribute.

Digging Deeper
For a helpful snippet on resolving most tabindex issues, see this.

called by GFFormDisplay::get_form() in form_display.php
gform_tabindex_{form_id} | filter more info

Form-specific version of the gform_tabindex filter. Example: gform_tabindex_1

Use this filter to modify the tabindex start value (default is 0) or to disable the tabindex attribute.

Digging Deeper
For a helpful snippet on resolving most tabindex issues, see this.

called by GFFormDisplay::get_form() in form_display.php
gform_pre_enqueue_scripts | action more info

Use this action to enqueue form scripts before Gravity Forms has enqueued it's own scripts.

Digging Deeper
Gravity Forms makes a second call to the GFFormDisplay::enqueue_form_scripts() method so that Gravity Forms scripts/styles are properly enqueued when the form is being loaded via the gravity_form() function call, rather than the shortcode.

If you're loading your form via the shortcode, you can ignore this. It won't cause you any issues.

called by GFFormsModel::enqueue_form_scripts() in form_display.php
gform_pre_enqueue_scripts_{form_id} | action more info

Form-specific version of the gform_pre_enqueue_scripts action. Example: gform_pre_enqueue_scripts_1

Use this action to enqueue form scripts before Gravity Forms has enqueued it's own scripts.

Digging Deeper
Gravity Forms makes a second call to the GFFormDisplay::enqueue_form_scripts() method so that Gravity Forms scripts/styles are properly enqueued when the form is being loaded via the gravity_form() function call, rather than the shortcode.

If you're loading your form via the shortcode, you can ignore this. It won't cause you any issues.

called by GFFormsModel::enqueue_form_scripts() in form_display.php
gform_has_conditional_logic | filter more info

Use this filter to override the GFFormDisplay::has_conditional_logic() check. If conditional logic has been enabled on the current form, this check will return true by default.

called by GFFormDisplay::has_conditional_logic() in form_display.php
gform_has_conditional_logic | filter more info

Use this filter to override the GFFormDisplay::has_conditional_logic() check. If conditional logic has been enabled on the current form, this check will return true by default.

called by GFFormDisplay::has_conditional_logic() in form_display.php
gform_enqueue_scripts | action more info

Use this action to enqueue form scripts after Gravity Forms has enqueued its own scripts. This is the preferred hook to use for enqueueing your own form scripts.

called by GFFormDisplay::enqueue_form_scripts() in form_display.php
gform_enqueue_scripts_{form_id} | action more info

Form-specific version of the gform_enqueue_scripts action. Example: gform_enqueue_scripts_1

Use this action to enqueue form scripts after Gravity Forms has enqueued its own scripts. This is the preferred hook to use for enqueueing your own form scripts.

called by GFFormDisplay::enqueue_form_scripts() in form_display.php
gform_is_form_editor | filter more info

Use this filter to override the GFCommon::is_form_editor() check.

Digging Deeper
Forms are displayed differently depending on the location in which they are loaded.

This filter is applied by the GFCommon::is_form_editor() method. The GFFormDisplay::get_form() method calls the is_form_editor() method to determine if the form is being loaded in the form editor. By default, this will return false if loading the form on the frontend.

called by GFCommon::is_form_editor() in common.php
gform_is_entry_detail | filter more info

Use this filter to override the GFCommon::is_entry_detail() check.

Digging Deeper
Forms are displayed differently depending on the location in which they are loaded.

This filter is applied by the GFCommon::is_entry_detail() method. The GFFormDisplay::get_form() method calls the is_entry_detail() method to determine if the form is being loaded in the entry detail view. By default, this will return false if loading the form on the frontend.

called by GFCommon::is_entry_detail() in common.php
gform_progressbar_start_at_zero | filter more info

Use this filter to modify the starting percentage of the progress bar for multi-page forms.

Digging Deeper
This filter defaults to the value of the "Display completed progress bar on confirmation" setting found "Start Paging" field settings. By default, the first page of a multi-page form will show the progress bar partially completed and the last page of the form will show the progress bar fully completed.

If you would like the progress bar to only be fully completed on the confirmation page, enable the "Display completed progress bar on confirmation" setting or use this filter to enable this setting for all forms.

called by GFFormDisplay::get_form() in form_display.php
gform_shortcode_form | filter more info

Use this filter to modify the complete form markup.

called by GFForms::parse_shortcode() in gravityforms.php

Did this resource help you do something awesome with Gravity Forms?

Then you'll absolutely love Gravity Perks; a suite of 47+ essential add-ons for Gravity Forms with support you can count on.

Comments

Alex says

January 9, 2023 at 5:35 am

This is a must for GF devs. Great resource. Thanks a lot for putting efforts into it.

Reply
- Samuel Bassah says
  
  January 9, 2023 at 6:50 am
  
  Hi Alex,
  
  Thanks for the kind words.
  
  Best,
Paco says

July 13, 2022 at 9:02 am

I know it is a stupid questions, but where I need to include these hooks? Using the add-on “code snippet in WordPress is a good way? Which are the other? Thanks a lot in advance

Reply
- Samuel Bassah says
  
  July 13, 2022 at 9:05 am
  
  Hi Paco,
  
  You can either insert the code in your function.php file or use the code snippet plugin. https://gravitywiz.com/documentation/how-do-i-install-a-snippet/
  
  Best,
Roger Upton says

November 10, 2021 at 10:47 am

Many thanks for this. It would be useful to include the gform_entry_field_value and gform_save_field_value in the sequence.

Reply
- Dario Space says
  
  November 10, 2021 at 10:51 am
  
  Hi Roger,
  
  Thanks, we will ping our dev team to update the docs.
  
  Best,
- Scott Ryer says
  
  November 15, 2021 at 11:12 am
  
  Hi Roger,
  
  gform_save_field_value is already listed in the Hooks Run on Successful Form Submission section under the Saving Fields heading.
  
  Our devs have confirmed that gform_entry_field_value isn’t called during any of the flows we cover with only Gravity Forms running.
Bryan Veloso says

May 4, 2021 at 9:28 pm

The gform_progressbar_start_at_zero doesn’t work anymore on Gravity Forms 2.5 and above.

Reply
- Samuel Bassah says
  
  May 5, 2021 at 6:12 am
  
  Hi Bryan,
  
  Thanks for bringing this to our attention. We’re currently updating our documents to reflect Gravity Forms 2.5, so we’ll be adding this to the list.
  
  Best,
chuteo007 says

March 16, 2020 at 11:57 pm

Hi David, How can I use jQuery to change $field->visibility, gwwordcount_max_word_count… when I click radio button? I can change with query string by using hook pre_render but cannot with js?

Reply
Jeffrey Moody says

February 5, 2018 at 7:54 pm

Hey David. Newbie here trying to make my bowling tournament’s registration site usable.

Brief version of what I have: A multipage gravityform that allows editing of submitted entries. I have it so that the first team member creates a user (team name) and a password. They then complete as much of the registration form as possible. Normally this means that they fill in their personal information (pages 2-5 each contain data required for one bowler). So, the first bowler registers as one of those bowlers and then submits the form. They then send the login info to the rest of their team and each team member goes in and completes their page on the registration.

Issue: I need to have it so that once a bowler registers, the data on that page is marked as read only (not disabled). So, in theory, what I would have is a checkbox, dropdown or radio button asking if the bowler is finished entering their personal data. If the answer is “yes” then when the form is submitted, the data on that specific page is made read only. However, the remaining pages are still editable by the other team members.

So, if the first person registers as bowler 4 (page 5) then after the form is submitted page 5 is read only from then on. Then when the next bowler goes in to register and uses page 2, then after they submit the form, pages 2 and 5 are now read only.

Is there a hook or process that would allow me to do this? I asked gravityforms support and they just said that this is not a feature that gravityforms offers.

Any help is greatly appreciated.

Reply
Tyrel Olsen says

March 8, 2017 at 6:43 pm

So I’m having issues getting and field validation to work and noticed my Gravity Forms form_display.php doesn’t contain GFFormDisplay::validate() anywhere inside of it. Where and how should I add it? Does it work for everyone else?

Reply
- David Smith says
  
  March 8, 2017 at 10:15 pm
  
  I would recommend downloading the latest version of Gravity Forms and overwriting whatever version you’re currently using.
  
  https://www.gravityhelp.com/downloads/
- Tyrel says
  
  March 9, 2017 at 8:26 am
  
  I’m updated to the current version. That was the first thing I tried ha.
- David Smith says
  
  March 9, 2017 at 9:13 am
  
  I’m running the latest version as well and the GFFormDisplay::validate() method is there for me. I’d reach out to Gravity Forms support.
Danny says

February 28, 2017 at 11:50 am

Simply a thank you, this page is so useful and I keep returning.

Reply
- David Smith says
  
  February 28, 2017 at 12:01 pm
  
  I’m really glad to hear it, Danny. :)
Richard Buff says

December 5, 2016 at 10:55 am

Wow, exactly what I was looking for. Wish I’d found this sooner, would have saved me a couple hours! Thanks!

Reply
- David Smith says
  
  December 5, 2016 at 9:22 pm
  
  Glad to help, Richard. :)
Sebastian says

November 3, 2016 at 4:40 pm

Hey. Nice work man :) I want to create a custom field for address. I do not now what is the best? I have been looking for filters to change content in the admin site but i am not sure witch filters should i use to change whole field object. And how to get access to this object in my functions? And also if is necessary to use javascript?

Reply
- David Smith says
  
  November 3, 2016 at 4:53 pm
  
  Hi Sebastian, I’m assuming you’re talking about creating a custom field type for Gravity Forms? If so, I would start here: https://www.gravityhelp.com/documentation/article/gf_field/
Ian says

September 28, 2016 at 2:45 pm

Fantastic resource! Where do these get called?

gform_field_value gform_field_value{$parameter}

Reply
- David Smith says
  
  September 28, 2016 at 4:42 pm
  
  Hi Ian, those hooks are called early in the “Field Markup Loop” when dynamic population is enabled (rough example).
Jm says

May 28, 2016 at 7:57 pm

Hello,

Is it possible to customize the entry details section on the admin? I would like to customize the data being displayed there. Thanks!

Reply
- David Smith says
  
  May 29, 2016 at 8:30 pm
  
  Yes, it is possible. The “how” will depend on exactly what you want to customize.
simon buerman says

April 29, 2016 at 6:09 pm

Hello i would like to know if it exist a hook to get the current page id and the last page id of a multipage form . i would like to do somthing like that:

numberofpage=last_page_id – first_page_id pourcentage_page=100/numberofpage

for(i=first_page_id,i<=last_page_id,i++){ pourcentage_page_specific=pourcentage_page*i } but i don’t see how retrieve the id of the last_page dynamicly

Reply
- David Smith says
  
  April 29, 2016 at 10:05 pm
  
  This would depend on where you’re running your code and what type of code you’re running (PHP, JS?).
- buerman says
  
  April 30, 2016 at 9:45 am
  
  I would want to make a percentage of submission of the form, on the same principle as a progress bar but without bar because I want to make that in the form of stage.
  
  I believe that the JS is more adapted but the place it is exactly the problem, I am not too much on to know where to put this code
- David Smith says
  
  May 2, 2016 at 11:00 pm
  
  Hey Simon, I think this question would be better directed to Gravity Forms support. I’m just not sure what you’re after and they have a much larger support team for fielding general Gravity Forms questions.
- buerman says
  
  May 3, 2016 at 6:56 am
  
  I have already asked the question to the support of gravity form but the only answer to which I was entitled it was called on to a developer freelance “you will agree that appeal to a developer freelance to make a simple function, it is a high price to pay:-)
- David Smith says
  
  May 3, 2016 at 8:44 am
  
  Hi Simon, I understand. To get the current page, you could use a hook like this one:
  
  https://www.gravityhelp.com/documentation/article/gform_page_loaded/
  
  To get the total page count you could use jQuery to find all the .gform_page elements and count their length.
  
  var pageCount = jQuery( ‘.gform_page’ ).length;
  
  The code could either go in an HTML field in your form (wrapped in <script> tags) or in your theme’s JS file.
Annie says

January 10, 2016 at 10:35 pm

Hi David!

I have a form that is loaded on a fancybox iframe, and on “Confirmation” I have it set to redirect to the page that was just created. Do you know if it would be possible to use a hook to set the target=”_parent” so the new page doesn’t load inside the iframe?

Thanks in advance!

Reply
- David Smith says
  
  March 15, 2016 at 6:45 am
  
  Hi Annie, here’s how to do this: https://gist.github.com/spivurno/ab0626e5c2fef4db1f2b
Rob says

December 29, 2015 at 8:36 pm

Hi David,

Do you know if there is a way to target a form confirmation/notification by name as opposed to ID? The Gravity Forms documentation gives an example which targets form with ID 6:

add_filter( ‘gform_confirmation_6’, ‘custom_confirmation’, 10, 4 );

But this means the ID’s of live forms have to match the ID’s of development forms, which for me is not always the case.

Thanks in advance, Rob

Reply
- David Smith says
  
  December 30, 2015 at 7:05 am
  
  Hi Rob, you should be able to do something like this: http://pastie.org/10660393
- Rob says
  
  December 30, 2015 at 4:20 pm
  
  Thanks David. That should work :)
Donna McMaster says

September 25, 2015 at 12:18 am

Thanks so much! Gravity Forms reworked their documentation structure so that it’s even less useful than before. You just saved me an hour of frustration trying to find the right hook!

Cheers! Donna

Reply
- David Smith says
  
  September 25, 2015 at 8:04 am
  
  Glad to help, Donna. :)
P.G. Ros says

August 18, 2015 at 5:34 am

Thank you so much for writing this article, I asked for this at gravirty support and you took the liberty of writing it! This is incredibly useful.

Reply
Chris Edwards says

August 10, 2015 at 3:16 pm

Using these, how can I put the Total price into the sidebar. I have it at the bottom of my form currently, but, would love to move it to the sidebar instead.

Reply
- David Smith says
  
  August 20, 2015 at 8:40 am
  
  You could use jQuery to move the field on page load. Or CSS to style it so it appears in the sidebar. Or if you want to get really fancy, you could write a custom widget that mimics the value from the form itself.
Wil Brown says

August 3, 2015 at 12:04 am

Fantastic resource David. Thanks for putting the time and effort into this.

Reply
- David Smith says
  
  August 3, 2015 at 12:02 pm
  
  Thanks, Wil. Glad you’ve found it useful. :)