email_exists( string $email )
Determines whether the given email exists.
Description Description
For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.
Parameters Parameters
-
(string) (Required) Email.
Return Return
(int|false) The user's ID on success, and false on failure.
More Information 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 Source
File: wp-includes/user.php
function email_exists( $email ) {
$user = get_user_by( 'email', $email );
if ( $user ) {
return $user->ID;
}
return false;
}
Expand full source code Collapse full source code View on Trac
Changelog Changelog
| Version | Description |
|---|---|
| 2.1.0 | Introduced. |
User Contributed Notes User Contributed Notes
You must log in before being able to contribute a note or feedback.
Example
If the E-mail exists, echo the ID number to which the E-mail is registered. Otherwise, tell the viewer that it does not exist.
$email = 'myemail@example.com'; $exists = email_exists( $email ); if ( $exists ) { echo "That E-mail is registered to user number " . $exists; } else { echo "That E-mail doesn't belong to any registered users on this site"; }