After a new user registration, WP sends out an email with the login / password, and a link to the login page.

Is there a way to change this defaut email template? I'd also like to change the subject and sender.

Edit : For anyone interested, here is a plugin solution.


3 Answers 3


The new user email is sent using the wp_new_user_notification() function. This function is pluggable, which means that you can overwrite it:

// Redefine user notification function
if ( !function_exists('wp_new_user_notification') ) {
    function wp_new_user_notification( $user_id, $plaintext_pass = '' ) {
        $user = new WP_User($user_id);

        $user_login = stripslashes($user->user_login);
        $user_email = stripslashes($user->user_email);

        $message  = sprintf(__('New user registration on your blog %s:'), get_option('blogname')) . "\r\n\r\n";
        $message .= sprintf(__('Username: %s'), $user_login) . "\r\n\r\n";
        $message .= sprintf(__('E-mail: %s'), $user_email) . "\r\n";

        @wp_mail(get_option('admin_email'), sprintf(__('[%s] New User Registration'), get_option('blogname')), $message);

        if ( empty($plaintext_pass) )

        $message  = __('Hi there,') . "\r\n\r\n";
        $message .= sprintf(__("Welcome to %s! Here's how to log in:"), get_option('blogname')) . "\r\n\r\n";
        $message .= wp_login_url() . "\r\n";
        $message .= sprintf(__('Username: %s'), $user_login) . "\r\n";
        $message .= sprintf(__('Password: %s'), $plaintext_pass) . "\r\n\r\n";
        $message .= sprintf(__('If you have any problems, please contact me at %s.'), get_option('admin_email')) . "\r\n\r\n";
        $message .= __('Adios!');

        wp_mail($user_email, sprintf(__('[%s] Your username and password'), get_option('blogname')), $message);


Note: Overriding pluggable functions cannot be done in the theme functions.php file. WP's pluggable file is already loaded by that point so the function would be defined by WP (i.e. the default). Your custom version must load before this happens, which means you must load it in a custom plugin file.

  • @Bainternet I cannot seem to get this to work, I have added this to my functions file, but the standard email keeps sending. I'm on multisite, but that shouldn't matter, right?
    – user2015
    Commented Jul 2, 2011 at 2:33
  • 7
    OK got it now, it only seems to work as a separate plugin, not when you add it to your functions.php file. Now it works perfect, thanks again for that nice piece of code!
    – user2015
    Commented Jul 2, 2011 at 3:03
  • Does it works for multisite too? I can see multisite has bunch of functions inside ms-functions.php for sending notification email.
    – Sisir
    Commented Jul 28, 2013 at 7:42
  • Multisite uses wpmu_signup_user_notification I think.
    – Wyck
    Commented Nov 25, 2014 at 21:43
  • 1
    This answer is several years old. The accepted answer doesn't work for me. (Adding it to functions.php has makes no difference to any of the emails sent when a new user registers.) Should I post a new question? Commented Apr 21, 2015 at 11:23

For 2018 and onwards users:

Since WordPress 4.9.0 there are new filters you can use for this (no need for a plugin anymore):

Usage example on email sent to Admin (you can paste this in your theme's functions.php ):

add_filter( 'wp_new_user_notification_email_admin', 'custom_wp_new_user_notification_email', 10, 3 );

function custom_wp_new_user_notification_email( $wp_new_user_notification_email, $user, $blogname ) {
    $wp_new_user_notification_email['subject'] = sprintf( '[%s] New user %s registered.', $blogname, $user->user_login );
    $wp_new_user_notification_email['message'] = sprintf( "%s ( %s ) has registerd to your blog %s.", $user->user_login, $user->user_email, $blogname );
    return $wp_new_user_notification_email;
  • 2
    Alternatively one could use the wp_new_user_notification_email and wp_new_user_notification_email_admin filters. Those interested can check out the full documentation and source code for wp_new_user_notification().
    – Pete
    Commented Jan 10, 2018 at 3:42
  • Thanks Pete, looks like that was introduced in 4.9.0 and looks like a better solution.
    – Edu Wass
    Commented Jan 10, 2018 at 12:24
  • Hi. I am also using the WP Approve User plugin. At the moment it sends the standard email when they sign up. It shouldn’t. It should say that account needs to be approved first. We Approve User has option to set the text for when the account has been approved and that is working right. It is the pre approved step before. Do I use these new filters you mentioned? Commented Dec 8, 2019 at 8:32
  • custom_wp_new_user_notification_email does not change the admin email content for us on wp 5.6
    – trainoasis
    Commented May 11, 2021 at 14:16

This will not work on functions.php. You need to put this code inside a plugin.

If you don't now to make a plugin for this just use this link.

Don't forget to take the update code of this function form here.

  • Just a point of clarification based on the addition of filter hooks to the wp_new_user_notification() function. This answer specifically references the overriding of wp_new_user_notification() as a pluggable function. However, this does not apply to using the wp_new_user_notification_email and wp_new_user_notification_email_admin filters. Those can be used in your functions.php file (or a site specific plugin).
    – butlerblog
    Commented Dec 9, 2019 at 13:24

Not the answer you're looking for? Browse other questions tagged or ask your own question.