W3cubDocs

/WordPress

email_exists( string $email )

Determines whether the given email exists.

Description

For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.

Parameters

$email

(string) (Required) Email.

Return

(int|false) The user's ID on success, and false on failure.

More Information

This function will check whether or not a given email address ($email) has already been registered to a username, and returns that users ID (or false if none exists). See also username_exists.

This function is normally used when a user is registering, to ensure that the E-mail address the user is attempting to register with has not already been registered.

Source

File: wp-includes/user.php 

function email_exists( $email ) {
	$user = get_user_by( 'email', $email );
	if ( $user ) {
		return $user->ID;
	}
	return false;
}

Uses

Uses Description
wp-includes/pluggable.php: get_user_by()

Retrieve user info by a given field

Used By

Used By Description
wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php: WP_REST_Users_Controller::update_item()

Updates a single user.
wp-includes/user.php: send_confirmation_on_profile_email()

Send a confirmation request email when a change of user email address is attempted.
wp-admin/includes/user.php: edit_user()

Edit user settings based on contents of $_POST
wp-includes/user.php: register_new_user()

Handles registering a new user.
wp-includes/user.php: wp_insert_user()

Insert a user into the database.
wp-includes/ms-functions.php: wpmu_validate_user_signup()

Sanitize and validate data required for a user sign-up.

Changelog

Version Description
2.1.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/email_exists