Add new or modify existing notification settings that display on the Notification Edit screen.


The following would apply to all forms.

add_filter( 'gform_notification_ui_settings', 'your_function_name', 10, 3 );

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

add_filter( 'gform_notification_ui_settings_5', 'your_function_name', 10, 3 );


  • $ui_settings array

    An array of settings for the notification UI. Each setting contains the HTML which will be displayed for that setting.

  • $confirmation array

    An array of properties which make up the current notification object to be edited. See Notifications Object for default properties.

  • $form

    The current form object to which the notification being edited belongs.


This example demonstrates how you can add a custom notification UI setting. Use with the gform_pre_notification_save hook to add the submitted value of your setting to the notification object. Use with the gform_notification_validation hook to ensure the value submitted for your setting is valid.

add_filter( 'gform_notification_ui_settings', 'my_custom_notification_setting', 10, 3 );
function my_custom_notification_setting( $ui_settings, $notification, $form ) {

    $ui_settings['my_custom_setting'] = '
            <th><label for="my_custom_setting">My Custom Label</label></th>
            <td><input value="' . rgar( $notification, 'my_custom_setting' ) . '" name="my_custom_setting"></td>

    return $ui_settings;

Source Code

This filter is located in GFNotification::get_notification_ui_settings() in notification.php