Title: password_change_email
Published: August 18, 2015
Last modified: May 20, 2026

---

# apply_filters( ‘password_change_email’, array $pass_change_email, array $user, array $userdata )

## In this article

 * [Parameters](https://developer.wordpress.org/reference/hooks/password_change_email/?output_format=md#parameters)
 * [Source](https://developer.wordpress.org/reference/hooks/password_change_email/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/hooks/password_change_email/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/hooks/password_change_email/?output_format=md#changelog)
 * [User Contributed Notes](https://developer.wordpress.org/reference/hooks/password_change_email/?output_format=md#user-contributed-notes)

[ Back to top](https://developer.wordpress.org/reference/hooks/password_change_email/?output_format=md#wp--skip-link--target)

Filters the contents of the email sent when the user’s password is changed.

## 󠀁[Parameters](https://developer.wordpress.org/reference/hooks/password_change_email/?output_format=md#parameters)󠁿

 `$pass_change_email`array

Used to build [wp_mail()](https://developer.wordpress.org/reference/functions/wp_mail/).

 * `to` string
 * The intended recipients. Add emails in a comma separated string.
 * `subject` string
 * The subject of the email.
 * `message` string
 * The content of the email.
    The following strings have a special meaning and will
   get replaced dynamically:
    - `###USERNAME###` The current user’s username.
    - `###ADMIN_EMAIL###` The admin email in case this was unexpected.
    - `###EMAIL###` The user’s email address.
    - `###SITENAME###` The name of the site.
    - `###SITEURL###` The URL to the site.
 * `headers` string
 * Headers. Add headers in a newline (rn) separated string.

`$user`array

The original user array.

`$userdata`array

The updated user array.

## 󠀁[Source](https://developer.wordpress.org/reference/hooks/password_change_email/?output_format=md#source)󠁿

    ```php
    $pass_change_email = apply_filters( 'password_change_email', $pass_change_email, $user, $userdata );
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/user.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/user.php#L2845)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/user.php#L2845-L2845)

## 󠀁[Related](https://developer.wordpress.org/reference/hooks/password_change_email/?output_format=md#related)󠁿

| Used by | Description | 
| [wp_update_user()](https://developer.wordpress.org/reference/functions/wp_update_user/)`wp-includes/user.php` |

Updates a user in the database.

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/hooks/password_change_email/?output_format=md#changelog)󠁿

| Version | Description | 
| [4.3.0](https://developer.wordpress.org/reference/since/4.3.0/) | Introduced. |

## 󠀁[User Contributed Notes](https://developer.wordpress.org/reference/hooks/password_change_email/?output_format=md#user-contributed-notes)󠁿

 1.   [Skip to note 3 content](https://developer.wordpress.org/reference/hooks/password_change_email/?output_format=md#comment-content-5514)
 2.    [marginean.doru](https://profiles.wordpress.org/margineandoru/)  [  4 years ago  ](https://developer.wordpress.org/reference/hooks/password_change_email/#comment-5514)
 3.  [You must log in to vote on the helpfulness of this note](https://login.wordpress.org?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fpassword_change_email%2F%23comment-5514)
     Vote results for this note: 0[You must log in to vote on the helpfulness of this note](https://login.wordpress.org?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fpassword_change_email%2F%23comment-5514)
 4.  Use the code below if you don’t wish to show your real administrator email inside
     password change notifications.
 5.  Change ‘other_email@your-domain.com’ to the new email address.
 6.      ```php
         /**
          * Change admin email in notifications.
          *
          * This applies to password change notifications.
          *
          * @param (array) $pass_change_email Used to build wp_mail().
          * @param (array) The original user array.
          * @param (array) The updated user array.
          *
          * @return (array) $pass_change_email Updated wp_mail() content.
          */
         add_filter('password_change_email', 'replace_admin_email_in_notification_emails', 10, 3);
     
         function replace_admin_email_in_notification_emails( $pass_change_email, $user, $userdata ) {
           $pass_change_email['message'] = str_replace( '###ADMIN_EMAIL###', 'other_email@your-domain.com', $pass_change_email['message'] );
     
           return $pass_change_email;
         }
         ```
     
 7.   [Log in to add feedback](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fpassword_change_email%2F%3Freplytocom%3D5514%23feedback-editor-5514)
 8.   [Skip to note 4 content](https://developer.wordpress.org/reference/hooks/password_change_email/?output_format=md#comment-content-2655)
 9.    [云落](https://profiles.wordpress.org/googlo/)  [  8 years ago  ](https://developer.wordpress.org/reference/hooks/password_change_email/#comment-2655)
 10. [You must log in to vote on the helpfulness of this note](https://login.wordpress.org?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fpassword_change_email%2F%23comment-2655)
     Vote results for this note: -2[You must log in to vote on the helpfulness of this note](https://login.wordpress.org?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fpassword_change_email%2F%23comment-2655)
 11.     ```php
         add_filter( 'password_change_email', '__return_false' );
         ```
     
 12. don’t send email when user change password
 13.  * This is the wrong hook to use for that goal. For that goal you should use [https://developer.wordpress.org/reference/hooks/send_password_change_email/](https://developer.wordpress.org/reference/hooks/send_password_change_email/)
      * Anonymous User [5 years ago](https://developer.wordpress.org/reference/hooks/password_change_email/#comment-5046)
 14.  [Log in to add feedback](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fpassword_change_email%2F%3Freplytocom%3D2655%23feedback-editor-2655)

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fpassword_change_email%2F)
before being able to contribute a note or feedback.