WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

user_registration_email

apply_filters( ‘user_registration_email’, string $user_email )

In this article

Back to top

Filters the email address of a user being registered.

Parameters

$user_emailstring
The email address of the new user.

More Information

This filter hooks into the very start of the register_new_user() function of wp-login.php after the user has been sanitized and it is used to manipulate the value submitted for user_email.

As it is the very first filter to be called in the registration process it’s a reasonable (i.e. not really good but possible) place to manipulate user registration data in $_POST as well as the email field itself before that data is further processed.

This means that it can be used for instance to set the email address field to be the same as the username (which on your registration form you could label as email address if you wanted to), and do other more interesting form customizations.

Source

$user_email = apply_filters( 'user_registration_email', $user_email );

View all references View on Trac View on GitHub

Used byDescription
register_new_user()wp-includes/user.php

Handles registering a new user.

Changelog

VersionDescription
2.1.0Introduced.

User Contributed Notes

  1. Skip to note 2 content
    Collins Mbaka
    You must log in to vote on the helpfulness of this noteVote results for this note: -3You must log in to vote on the helpfulness of this note

    An Example

    function wpdocs_use_email_as_username( $user_email ) {
	return $_POST['user_login'];
}

add_filter( 'user_registration_email', 'wpdocs_use_email_as_username' );

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