How to Include Field Descriptions Inside Email Notifications

Introduction

Would you like to include Field Descriptions inside your email notifications? By default, the {all_fields} includes all form fields and labels that are filled in from the form with the exception of descriptions. However, you can easily include descriptions inside email notifications using a small PHP snippet. In this tutorial, we’ll walk you through each step on how to achieve this!

Creating your form

First, you’ll need to create your form. Our form will have just a few fields included and only one field will have the Field Description entered.

Once you’ve created your form, just complete the Field Descriptions you want to include in your email notification.

Add your field descriptions to be included inside your email notifications

If you need any assistance in creating your form, please visit this documentation.

Using the HTML or Plain Text Email Template

In this tutorial, we’re going to give you both code snippets that will include your Field Descriptions inside your email notifications regardless if you are using the HTML Email Template or the Plain text emails.

If you’re not sure which setting you have or what this setting is, you can always review this documentation to see where to change this option.

For our tutorial, we’re using the HTML Email Template.

In your WPForms Settings on the Email tab, this tutorial is using the HTML Email Template setting

Adding the snippet

Now it’s time to add the snippet to your site. If you need any help in adding snippets to your site, please see this tutorial.

/*
 * Include field descriptions inside email notifications.
 *
 * @link https://wpforms.com/developers/how-to-include-field-descriptions-inside-email-notifications/
 */

// HTML Email Template snippet

function wpf_dev_html_field_value($field_val, $field, $form_data, $context) {
  
	if ( $context !== 'email-html' ) {
	    return $field_val;
	}

	if ( empty( $form_data[ 'fields' ][ $field[ 'id' ] ] ) ) {
	    return $field_val;
	}

	$field_data = $form_data[ 'fields' ][ $field[ 'id' ] ];

	if ( empty( $field_data[ 'description' ] ) ) {
	    return $field_val;
	}

	return $field_val . '<p>' . $field_data[ 'description' ] . '</p>';

}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 10, 4 );



// Plain text email snippet

function wpf_dev_plaintext_field_value($field_val, $field, $form_data) {
  
    if ( empty( $form_data[ 'fields' ][ $field[ 'id' ] ] ) ) {
        return $field_val;
    }
 
    $field_data = $form_data[ 'fields' ][ $field[ 'id' ] ];

    if ( empty( $field_data[ 'description' ] ) ) {
        return $field_val;
    }
     
    $field_val = str_replace( [ "\r", "\n" ], '', $field_val );

    return $field_val . "\r\n" . $field_data[ 'description' ] . "\r\n\r\n";

}
add_filter( 'wpforms_plaintext_field_value', 'wpf_dev_plaintext_field_value', 10, 3 );

By adding this snippet, your field descriptions will be included in all of your email notifications.

now the field descriptions will be included in each notification

And that’s it! You’ve now included the Field Descriptions inside your email notifications! Would you like to also hide image choices from email notifications? Take a look at the article on How to Hide Image Choices in Notification Emails.

FAQ

Q: Can I style the Field Descriptions in the notification?

A: If you’re using the HTML Email Template for your email notifications, you can add some CSS styling to the Field Descriptions by using this snippet.

/*
 * Include field descriptions inside email notifications.
 *
 * @link https://wpforms.com/developers/how-to-include-field-descriptions-inside-email-notifications/
 */

function wpf_dev_html_field_value($field_val, $field, $form_data, $context) {
  
	if ( $context !== 'email-html' ) {
	    return $field_val;
	}

	if ( empty( $form_data[ 'fields' ][ $field[ 'id' ] ] ) ) {
	    return $field_val;
	}

	$field_data = $form_data[ 'fields' ][ $field[ 'id' ] ];

	if ( empty( $field_data[ 'description' ] ) ) {
	    return $field_val;
	}

	return $field_val . '<p style="padding:10px;background-color:#f6f6f6; color: #333333;"><i>' . $field_data[ 'description' ] . '</i></p>';

}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 10, 4 );

Now you can add styling to the Field Descriptions with this filter