wp_new_user_notification_email filter-hookWP 4.9.0

Filters the contents of the new user notification email sent to the new user.


add_filter( 'wp_new_user_notification_email', 'wp_kama_new_user_notification_email_filter', 10, 3 );

 * Function for `wp_new_user_notification_email` filter-hook.
 * @param array   $wp_new_user_notification_email Used to build wp_mail().
 * @param WP_User $user                           User object for new user.
 * @param string  $blogname                       The site title.
 * @return array
function wp_kama_new_user_notification_email_filter( $wp_new_user_notification_email, $user, $blogname ){

	// filter...
	return $wp_new_user_notification_email;

Used to build wp_mail().

  • to(string)
    The intended recipient - New user email address.

  • subject(string)
    The subject of the email.

  • message(string)
    The body of the email.

  • headers(string)
    The headers of the email.
User object for new user.
The site title.


Since 4.9.0 Introduced.

Where the hook is called

wp-includes/pluggable.php 2255
$wp_new_user_notification_email = apply_filters( 'wp_new_user_notification_email', $wp_new_user_notification_email, $user, $blogname );

Where the hook is used in WordPress

Usage not found.