user_register – Hook | Developer.WordPress.org

Fires immediately after a new user is registered.

Parameters

$user_idint

User ID.

$userdataarray

The raw array of data passed to wp_insert_user() .

More Arguments from wp_insert_user( … $userdata )

An array, object, or WP_User object of user data arguments.

ID int
User ID. If supplied, the user will be updated.
user_pass string
The plain-text user password for new users.
Hashed password for existing users.
user_login string
The user’s login username.
user_nicename string
The URL-friendly user name.
user_url string
The user URL.
user_email string
The user email address.
display_name string
The user’s display name.
Default is the user’s username.
nickname string
The user’s nickname.
Default is the user’s username.
first_name string
The user’s first name. For new users, will be used to build the first part of the user’s display name if $display_name is not specified.
last_name string
The user’s last name. For new users, will be used to build the second part of the user’s display name if $display_name is not specified.
description string
The user’s biographical description.
rich_editing string
Whether to enable the rich-editor for the user.
Accepts 'true' or 'false' as a string literal, not boolean. Default 'true'.
syntax_highlighting string
Whether to enable the rich code editor for the user.
Accepts 'true' or 'false' as a string literal, not boolean. Default 'true'.
comment_shortcuts string
Whether to enable comment moderation keyboard shortcuts for the user. Accepts 'true' or 'false' as a string literal, not boolean. Default 'false'.
admin_color string
Admin color scheme for the user. Default 'fresh'.
use_ssl bool
Whether the user should always access the admin over https. Default false.
user_registered string
Date the user registered in UTC. Format is ‘Y-m-d H:i:s’.
user_activation_key string
Password reset key. Default empty.
spam bool
Multisite only. Whether the user is marked as spam.
Default false.
show_admin_bar_front string
Whether to display the Admin Bar for the user on the site’s front end. Accepts 'true' or 'false' as a string literal, not boolean. Default 'true'.
role string
User’s role.
locale string
User’s locale. Default empty.
meta_input array
Array of custom user meta values keyed by meta key.
Default empty.

More Information

This action hook allows you to access data for a new user immediately after they are added to the database. The user id is passed to hook as an argument.

Not all user meta data has been stored in the database when this action is triggered. For example, nickname is in the database but first_name and last_name are not (as of v3.9.1). The password has already been encrypted when this action is triggered.

Typically, this hook is used for saving additional user meta passed by custom registration forms.

Source

do_action( 'user_register', $user_id, $userdata );

View all references View on Trac View on GitHub

Used by	Description
wp_insert_user()`wp-includes/user.php`	Inserts a user into the database.

Changelog

Version	Description
5.8.0	The `$userdata` parameter was added.
1.5.0	Introduced.

User Contributed Notes

Skip to note 4 content

Steven Lin 5 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 5You must log in to vote on the helpfulness of this note
Example migrated from Codex:

This example will save a first_name field passed by a custom registration field.

Also, keep in mind that validation of registration fields should not be performed within this hook! Validate using the registration_errors hook instead (the user_register hook will not be called if registration_errors validation fails).
```
add_action( 'user_register', 'myplugin_registration_save', 10, 1 );

function myplugin_registration_save( $user_id ) {

    if ( isset( $_POST['first_name'] ) )
        update_user_meta($user_id, 'first_name', $_POST['first_name']);

}
```
Log in to add feedback
Skip to note 5 content

Omid Beheshtian 5 years ago

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
We can use this php code to update database from
own custom register field.
```
add_action( 'user_register', function ( $user_id ) {
    $userdata = array();
    $userdata['ID'] = $user_id;
    $userdata['telnumber'] = $_POST['telnumber'];
    wp_update_user( $userdata );
} );
```
Log in to add feedback
Skip to note 6 content

Armin Amiri Nasab 10 months ago

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
In this code we send an email when user register at our site:
```
add_action( 'user_register', function ( $userID, $userData ) {
    wp_mail( $userData['user_email'], __( 'Welcome' ) . ' ' . $userData['nickname'], __( 'Welcome to our site :)' ) );
}, 10, 2 );
```
Log in to add feedback

do_action( ‘user_register’, int $user_id, array $userdata )

In this article

Parameters

More Information

Source

Changelog

User Contributed Notes

do_action( ‘user_register’, int $user_id, array $userdata )

In this article

Parameters

More Information

Source

Related

Changelog

User Contributed Notes