Skip to main content

Setting Up Conditional Recipients in Divi Form Builder

Conditional recipients allow you to send form submissions to different email addresses based on certain conditions. This is useful for directing form responses to the appropriate departments or individuals, ensuring that communications are efficiently managed.

What You Will Need​

To set up conditional recipients, you need the Form ID and the IDs of the fields you want to use in your conditions. These IDs are unique identifiers for your form and fields.

  1. Form ID: Edit your Divi Form Builder module and within the Main Options setting, add or copy the Form ID.
  2. Field ID(s): Edit your Divi Form Builder module, open the settings for the relevant field, and add or copy the Field ID under Field Options.
note

You can use as many fields as you like, and they can be any field type. It's recommended to use fields with pre-defined options such as Select, Checkbox, or Radio fields for predictable values.

Step 1: Create and Add Your Conditional Recipient Function​

Single Field Conditional Code​

The below example of code needs to be added to your child themes function.php file. You need to replace the $form_id with the Form ID you have defined in the previous step. The $form_data sets your Field ID and the condition has to be exactly as it is defined in your form.

For this example, we have a Select field with the options Sales and Support.

function custom_contact_recipient( $mail_to, $form_id, $form_data ) {
    // Enter your form ID here
    if ( $form_id == 'add_post_form' ) {
    // These are the field conditions. We enter the field ID here and the expected value
        if ( $form_data['department'] == 'Sales' ) {
            $mail_to = '[email protected]';
        } else if ( $form_data['department'] == 'Support' ) {
            $mail_to = '[email protected]';
        }
    }
    return $mail_to;
}

Multiple Field Conditional Code​

You can also create conditions based on multiple field values!

The below example of code needs to be added to your child themes function.php file. You need to replace the $form_id with the Form ID you have defined in the previous step. The $form_data sets your Field ID and the condition has to be exactly as it is defined in your form.

For this example, we have a Select field with the options Sales and Support and a Select Field for our products.

function custom_contact_recipient( $mail_to, $form_id, $form_data ) {
    // Enter your form ID here
    if ( $form_id == 'add_post_form' ) {
        // These are the field conditions. We enter the field ID here and the expected value     
        
        // First condition checks if the Department field is equal to Sales and the Products field is equal to Form Builder
        if ( $form_data['department'] == 'Sales' && $form_data['products'] == 'Form Builder' ) {
            $mail_to = '[email protected]';
        } else if ( $form_data['department'] == 'Sales' && $form_data['products'] == 'Bodycommerce' ) {
            $mail_to = '[email protected]';
        } else if ( $form_data['department'] == 'Support' && $form_data['products'] == 'Form Builder' ) {
            $mail_to = '[email protected]';
         } else if ( $form_data['department'] == 'Support' && $form_data['products'] == 'Bodycommerce' ) {
            $mail_to = '[email protected]';
        }
    }
    return $mail_to;
}

Multiple Forms With Different Conditions Code​

You can use this code with multiple forms that have different conditions.

function custom_contact_recipient( $mail_to, $form_id, $form_data ) {
    // Enter your form ID here
    if ( $form_id == 'add_post_form' ) {
        // These are the field conditions. We enter the field ID here and the expected value     
        
        // First condition checks if the Department field is equal to Sales and the Products field is equal to Form Builder
        if ( $form_data['department'] == 'Sales' && $form_data['products'] == 'Form Builder' ) {
            $mail_to = '[email protected]';
        } else if ( $form_data['department'] == 'Sales' && $form_data['products'] == 'Bodycommerce' ) {
            $mail_to = '[email protected]';
        } else if ( $form_data['department'] == 'Support' && $form_data['products'] == 'Form Builder' ) {
            $mail_to = '[email protected]';
         } else if ( $form_data['department'] == 'Support' && $form_data['products'] == 'Bodycommerce' ) {
            $mail_to = '[email protected]';
        }
    } else if ( $form_id == 'second_form_id' ) {
        // These are the field conditions. We enter the field ID here and the expected value     
        
        // First condition checks if the Department field is equal to Sales and the Products field is equal to Form Builder
        if ( $form_data['day'] == 'Monday') {
            $mail_to = '[email protected]';
        } else if ( $form_data['day'] == 'Tuesday') {
                $mail_to = '[email protected]';
    }
    return $mail_to;
}

No Conditions Met?​

If none of the conditions you define are met, the standard form recipient defined in your Form Builder Form Module will be used.

Step 2: Add Your Filter​

Add the filter to your functions.php file to enable your function to interact with the form process.

// Use this filter if your form type is a contact form
add_filter('df_contact_recipient', 'custom_contact_recipient', 10, 3);

// Use this filter if your form type is anything else
add_filter('df_notification_recipient', 'custom_contact_recipient', 10, 3);

If you have multiple forms and some are contact forms while others are different types, rename your filter and adjust the function name in the filter.

Example:

// This filter will work for contact from conditional recipients. The custom_contact_recipient is the function name.
add_filter('df_contact_recipient', 'custom_contact_recipient', 10, 3);

// Use this filter will work for my create post form type. The custom_form_recipient is the function name
add_filter('df_notification_recipient', 'custom_form_recipient', 10, 3);

// This is the function for the contact form 
function custom_contact_recipient( $mail_to, $form_id, $form_data ) {

     /*** Your conditions go here ***/
     
}
// This is the function for the create post form type - you can put conditions here for any form type 
function custom_form_recipient( $mail_to, $form_id, $form_data ) {

     /*** Your conditions go here ***/

}

Additional Tips​

By following these steps, you can effectively set up conditional recipients for your Divi Form Builder forms, ensuring the right people receive the appropriate form submissions.

Last updated on