Description

Filters confirmation message output site-wide.

Parameters

$message
(string) (Required) Confirmation message, including processed Smart Tags.
$form_data
(array) (Required) Form data and settings.
$fields
(array) (Required) Sanitized field data.
$entry_id
(int) (Required) Entry id.

Source

wpforms/includes/class-frontend.php

More Information

The wpforms_frontend_confirmation_message filter is applied to all forms set to display a confirmation message. It can be used to change or replace the confirmation message that’s displayed, overriding the message contents set within the form builder.

Examples

This example shown below will capture the user name that filled out the form and then give a more personalized message for the confirmation.

Just remember to change the form ID from 25 to match the specific form ID you’re wanting to run your code on. Removing that check would run for all forms.

/**
 * Filters confirmation message output site-wide.
 *
 * @link   https://wpforms.com/developers/wpforms_frontend_confirmation_message/
 * 
 * @param  string $message   Confirmation message including Smart Tags.
 * @param  array  $form_data Form data and settings.
 * @param  array  $fields    Sanitized field data.
 * @param  int    $entry_id  Entry ID.
 * @return $message
 */
function wpf_dev_frontend_confirmation_message( $message, $form_data, $fields, $entry_id ) {
    // Only run on my form with ID = 25
    if ( absint( $form_data['id'] ) !== 25 ) {
            return $message;
        } 
         
    // Get the name field ID '0' to set the name for the message
    $contact_name = $fields['0']['value'];
	
    // Add the name to the message
    $message = "Thanks $contact_name we will be in touch!";
    return $message;
     
}
add_filter( 'wpforms_frontend_confirmation_message', 'wpf_dev_frontend_confirmation_message', 10, 4 );

The wpforms_frontend_confirmation_message filter