WordPress at a glance
Home WordPress Codex

Emails In WordPress

WordPress sends emails in different situations. This note contains all the possible cases when WordPress sends an email.

This is accurate as of WordPress 4.9.

Contents:

Comments

Comment is awaiting moderation

To:        Site Admin, plus post author if they can edit comments
From:      WordPress <wordpress@host>
Subject:   [%s] Please moderate: "%s"
Pluggable: Yes
Function:  wp_notify_moderator()
Filters:   comment_moderation_subject
		   comment_moderation_text
		   comment_moderation_recipients
		   comment_moderation_headers
Disable:   Return false from notify_moderator filter
		   Remove wp_new_comment_notify_moderator action on comment_post hook
		   "Email me whenever" on Settings -> Discussion
		   Overwrite the pluggable function

Comment has been published

To:        Post author
From:      WordPress <wordpress@host>
Subject:   [%s] Comment: "%s"
		   [%s] Pingback: "%s"
		   [%s] Trackback: "%s"
Pluggable: Yes
Function:  wp_notify_postauthor()
Filters:   comment_notification_subject
		   comment_notification_text
		   comment_notification_recipients
		   comment_notification_headers
Disable:   Return false from notify_post_author filter
		   Remove wp_new_comment_notify_postauthor action on comment_post hook
		   Overwrite the pluggable function
		   See also the hardcoded action added to wp_set_comment_status in wp_set_comment_status()

Change of Admin Email

Change of site admin email address is attempted (Prior to WordPress 4.9, this was Multisite-only)

To:        Proposed new email address
From:      WordPress <wordpress@host>
Subject:   [%s] New Admin Email Address
Pluggable: No
Function:  update_option_new_admin_email()
Filters:   new_admin_email_content
Disable:   Remove action on add_option_new_admin_email and update_option_new_admin_email hooks

Site admin email address is changed (WordPress 4.9+)

To:        Old site admin email address
From:      WordPress <wordpress@host>
Subject:   [%s] Notice of Admin Email Change
Pluggable: No
Function:  wp_site_admin_email_change_notification()
Filters:   site_admin_email_change_email
Disable:   Return false from send_site_admin_email_change_email filter

Multisite only: Change of network admin email address is attempted (WordPress 4.9+)

To:        Proposed new email address
From:      WordPress <wordpress@host>
Subject:   [%s] New Network Admin Email Address
Pluggable: No
Function:  update_network_option_new_admin_email()
Filters:   new_network_admin_email_content
Disable:   Remove action on add_site_option_new_admin_email and update_site_option_new_admin_email hooks

Multisite only: Network admin email address is changed (WordPress 4.9+)

To:        Old network admin email address
From:      WordPress <wordpress@host>
Subject:   [%s] Notice of Network Admin Email Change
Pluggable: No
Function:  wp_network_admin_email_change_notification()
Filters:   network_admin_email_change_email
Disable:   Return false from send_network_admin_email_change_email filter

Change of User Email or Password

User requests a password reset via "Lost your password?"

To:        User
From:      WordPress <wordpress@host>
Subject:   [%s] Password Reset
Pluggable: No
Function:  retrieve_password()
Filters:   retrieve_password_title
		   retrieve_password_message
Disable:   Not possible

User resets their password

To:        Site admin
From:      WordPress <wordpress@host>
Subject:   [%s] Password Changed
Pluggable: Yes
Function:  wp_password_change_notification()
Filters:   wp_password_change_notification_email (WordPress 4.9+)
Disable:   Remove action on after_password_reset hook
		   Overwrite the pluggable function

User attempts to change their email address (Prior to WordPress 4.9, this was Multisite-only)

To:        Proposed new email address
From:      WordPress <wordpress@host>
Subject:   [%s] New Email Address
Pluggable: No
Function:  send_confirmation_on_profile_email()
Filters:   new_user_email_content
Disable:   Remove action on personal_options_update hook

User changes their password

To:        User
From:      WordPress <wordpress@host>
Subject:   [%s] Notice of Password Change
Pluggable: No
Function:  wp_update_user()
Filters:   password_change_email
Disable:   Return false from send_password_change_email filter

User changes their email address

To:        User
From:      WordPress <wordpress@host>
Subject:   [%s] Notice of Email Change
Pluggable: No
Function:  wp_update_user()
Filters:   email_change_email
Disable:   Return false from send_email_change_email filter

Automatic Updates

Completion or failure of a background automatic core update

To:        Site admin / Network admin
From:      WordPress <wordpress@host>
Subject:   [%s] Your site has updated to WordPress %s
		   [%s] WordPress %s is available. Please update!
		   [%s] URGENT: Your site may be down due to a failed update
Pluggable: No
Function:  WP_Automatic_Updater::send_email()
Filters:   auto_core_update_email
Disable:   Return false from auto_core_update_send_email filter
		   Return false from send_core_update_notification_email filter

Full log of background update results, sent when you are using a development version of WordPress

To:        Site admin / Network admin
From:      WordPress <wordpress@host>
Subject:   [%s] There were failures during background updates
		   [%s] Background updates have finished
Pluggable: No
Function:  WP_Automatic_Updater::send_debug_email()
Filters:   automatic_updates_debug_email
Disable:   Return false from automatic_updates_send_debug_email filter

New User

Multisite only: An existing user is invited to a site from Users -> Add New -> Add Existing User

To:        User being invited
From:      WordPress <wordpress@host>
Subject:   [%s] Joining confirmation
Pluggable: No
Function:  wp-admin/user-new.php
Filters:   None
Disable:   Click the "Skip Confirmation Email" checkbox when adding the user

Multisite only: A new user is invited to a site from Users -> Add New -> Add New User

To:        User being invited
From:      [Network Name] <[network admin]>
Subject:   [%s] Activate %s
Pluggable: No
Function:  wpmu_signup_user_notification()
Filters:   wpmu_signup_user_notification_subject
		   wpmu_signup_user_notification_email
Disable:   Click the "Skip Confirmation Email" checkbox when adding the user
		   Return false from wpmu_signup_user_notification filter

Multisite only: A new user account is created

To:        Network Admin
From:      WordPress <wordpress@host>
Subject:   New User Registration: %s
Pluggable: No
Function:  newuser_notify_siteadmin()
Filters:   newuser_notify_siteadmin
Disable:   Filter registrationnotification option value
		   Remove action on wpmu_new_user hook
		   Toggle "Registration notification" in Network Admin -> Settings

Multisite only: A user has been added, or their account activation has been successful

To:        User being added
From:      [Network Name] <[network admin]>
Subject:   New %s User: %s
Pluggable: No
Function:  wpmu_welcome_user_notification()
Filters:   update_welcome_user_subject
		   update_welcome_user_email
		   See also "Welcome User Email" setting in Network Admin -> Settings
Disable:   Click the "Skip Confirmation Email" checkbox when adding the user
		   Return false from wpmu_welcome_user_notification filter
		   Remove action on wpmu_activate_user hook

A new user is created

When a new user is created, two emails are sent from the same function. One to the site admin:

To:        Site Admin
From:      WordPress <wordpress@host>
Subject:   [%s] New User Registration

and one to the newly created user:

To:        User being added
From:      WordPress <wordpress@host>
Subject:   [%s] Your username and password info

Details:

Pluggable: Yes
Function:  wp_new_user_notification()
Filters:   wp_new_user_notification_email_admin (WordPress 4.9+)
		   wp_new_user_notification_email (WordPress 4.9+)
Disable:   Remove wp_send_new_user_notifications action on register_new_user hook
		   Remove wp_send_new_user_notifications action on edit_user_created_user hook
		   Remove wp_send_new_user_notifications action on network_site_new_created_user hook
		   Remove wp_send_new_user_notifications action on network_site_users_created_user hook
		   Remove wp_send_new_user_notifications action on network_user_new_created_user hook
		   Overwrite the pluggable function
menu

New Site

When WordPress is installed, and when a site is added to a Multisite network

To:        Site Admin
From:      WordPress <wordpress@host>
Subject:   New WordPress Site
Pluggable: Yes
Function:  wp_new_blog_notification()
Filters:   None
Disable:   Overwrite the pluggable function
Multisite only: New site created from Network Admin -> Sites -> Add New
To:        Network Admin
From:      Site Admin <[network admin]>
Subject:   [%s] New Site Created
Pluggable: No
Function:  wp-admin/network/site-new.php
Filters:   None
Disable:   Not possible

Multisite only: User registers for a new site

To:        Site Admin
From:      [Network Name] <[network admin]>
Subject:   [%s] Activate %s
Pluggable: No
Function:  wpmu_signup_blog_notification()
Filters:   wpmu_signup_blog_notification_subject
		   wpmu_signup_blog_notification_email
Disable:   Return false from wpmu_signup_blog_notification filter
		   Remove action on after_signup_site hook

Multisite only: User activates their new site, or site added from Network Admin -> Sites -> Add New

To:        Network Admin
From:      WordPress <wordpress@host>
Subject:   New Site Registration: %s
Pluggable: No
Function:  newblog_notify_siteadmin()
Filters:   newblog_notify_siteadmin
Disable:   Filter registrationnotification option value
		   Remove action on wpmu_new_blog hook
		   Toggle "Registration notification" in Network Admin -> Settings

Multisite only: User activates their new site, or site added from Network Admin -> Sites -> Add New

To:        Site Admin
From:      [Network Name] <[network admin]>
Subject:   New %s Site: %s
Pluggable: No
Function:  wpmu_welcome_notification()
Filters:   update_welcome_subject
		   update_welcome_email
		   See also "Welcome Email" setting in Network Admin -> Settings
Disable:   Return false from wpmu_welcome_notification filter
		   Remove action on wpmu_activate_blog hook
menu

Other

Multisite only: Site admin deletes site from Tools -> Delete Site

To:        Site Admin
From:      WordPress <wordpress@host>
Subject:   [ %s ] Delete My Site
Pluggable: No
Function:  wp-admin/ms-delete-site.php
Filters:   delete_site_email_content
Disable:   Not possible

-

Source

No comments
    Hello, !     Log In . Register