Send email notification when user role changes

Adding this snippet to the functions.php of your wordpress theme will send the member an email notification when the user's role has changed.

Code Snippet:

function user_role_update( $user_id, $new_role ) {
$site_url = get_bloginfo('wpurl');
$user_info = get_userdata( $user_id );
$to = $user_info->user_email;
$subject = "Role changed: ".$site_url."";
$message = "Hello " .$user_info->display_name . " your role has changed on ".$site_url.", congratulations you are now an " . $new_role;
wp_mail($to, $subject, $message);
add_action( 'set_user_role', 'user_role_update', 10, 2);

Comments  Leave a Reply

  1. This was super helpful! Thank you!

  2. Mariusz Szatkowski October 31, 2013 at 6:59 am


    1. Thanks for the snippet – but I want to notify user only when the role of existing user is changed.

    Now the script sends an email when new user is added to WP.

    2. It would be more accurate to send the role name (now it sends the slug)

    Any ideas?


  3. Mariusz Szatkowski September 18, 2013 at 1:56 am

    Hi, thanks for that snippet. What about sending notification when the role is changed to certain name?

    Eg. I want to send the notification when the user role is changed to ‘group-x’…

    Thanks and kind regards

  4. Tiago Dufau de Vargas September 6, 2013 at 3:43 pm

    Saved me a day of research!! Thanks a lot.

  5. Any idea how to solve this if you want the email to be sent only when you change their role, not when you set the role? With this snippet, an email will be sent when you add a new user. An email will also be sent when you update e.g a users firstname (not touching the role).

    1. Tiago Dufau de Vargas September 6, 2013 at 3:46 pm

      You could try to use get_userdata and verify if the current user role is different than the new one…

  6. Brilliant! Thanks!

    1. Thanks Raam, glad to hear you like it.

Add a Comment

We're glad you have chosen to leave a comment. Please keep in mind that all comments are moderated according to our privacy policy, and all links are nofollow. Do NOT use keywords in the name field. Let's have a personal and meaningful conversation.

WordPress Launch Checklist

The Ultimate WordPress Launch Checklist

We've compiled all the essential checklist items for your next WordPress website launch into one handy ebook.
Yes, Send Me the Free eBook!