This filter is executed when a form fails validation, before the validation message is displayed. Use this filter to change the default validation message.


Applies to all forms

add_filter( 'gform_validation_message', 'your_function_name', 10, 2 );

To limit the scope of your function to a specific form, append the form id to the end of the hook name. (format: gform_validation_message_FORMID)

add_filter( 'gform_validation_message_5', 'your_function_name', 10, 2 );


  • $message string

    The validation message to be filtered.

    "<div class='validation_error'>" . esc_html__( 'There was a problem with your submission.', 'gravityforms' ) . ' ' . esc_html__( 'Errors have been highlighted below.', 'gravityforms' ) . '</div>'

  • $form

    The current form.


This example uses the gform_validation_message filter to change the default validation message.

add_filter( 'gform_validation_message', 'change_message', 10, 2 );
function change_message( $message, $form ) {
    return "<div class='validation_error'>Failed Validation - " . $form['title'] . '</div>';


This code should be placed in the functions.php file of your active theme.

Source Code

This filter is located in GFFormDisplay::get_form() in form_display.php