email_exists( string $email )

Determines whether the given email exists.

Contents

Description Description

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

Parameters Parameters

$email

(string) (Required) Email.

Top ↑

Return Return

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

Top ↑

Source Source

File: wp-includes/user.php

1433
1434
1435
1436
1437
1438
1439
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

Top ↑

Changelog Changelog

Changelog
Version Description
2.1.0 Introduced.

Top ↑

Top ↑

Used By Used By

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.
Show 1 more used by Hide more used by

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
    Contributed by Codex —

    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.

    1
    2
    3
    4
    5
    6
    7
    $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";
    }

You must log in before being able to contribute a note or feedback.