WordPress.org

Function Reference/wp insert user

Description

Insert a user into the database.

Can update a current user or insert a new user based on whether the user's ID is present.

Can be used to update the user's info (see below), set the user's role, and set the user's preference on the use of the rich editor.

Note: As late as 2.7.1, if you are attempting to update the password for the user, this function will not hash the password, thus failing. Use the wp_update_user function instead.

Note: 3.4.1, does hash the password. You can verify this in the [wp-includes/user.php](http://core.trac.wordpress.org/browser/tags/3.4.1/wp-includes/user.php#L1264)

Usage

<?php wp_insert_user( $userdata ) ?>

Parameters

$userdata

(mixed) (required) An array of user data, stdClass or WP_User object.

Default: None

Return Values

(mixed): If successful, returns the newly-created user's user_id, otherwise returns a WP_Error object.

Examples

Below is an example showing how to update a user's Website profile field

<?php
$user_id = 1;
$website = 'http://wordpress.org';
wp_insert_user( array ('ID' => $user_id, 'user_url' => $website) ) ;
?>

Notes

Uses: $wpdb WordPress database layer.
Uses: apply_filters() Calls filters for most of the $userdata fields with the prefix 'pre_user'. See description above.
Uses: do_action() Calls 'profile_update' hook when updating giving the user's ID
Uses: do_action() Calls 'user_register' hook when creating a new user giving the user's ID

The `$userdata` array can contain the following fields
Field Name	Description	Associated Filter
ID	An integer that will be used for updating an existing user.	(none)
user_pass	A string that contains the plain text password for the user.	`pre_user_pass`
user_login	A string that contains the user's username for logging in.	`pre_user_login`
user_nicename	A string that contains a URL-friendly name for the user. The default is the user's username.	`pre_user_nicename`
user_url	A string containing the user's URL for the user's web site.	`pre_user_url`
user_email	A string containing the user's email address.	`pre_user_email`
display_name	A string that will be shown on the site. Defaults to user's username. It is likely that you will want to change this, for both appearance and security through obscurity (that is if you dont use and delete the default admin user).	`pre_user_display_name`
nickname	The user's nickname, defaults to the user's username.	`pre_user_nickname`
first_name	The user's first name.	`pre_user_first_name`
last_name	The user's last name.	`pre_user_last_name`
description	A string containing content about the user.	`pre_user_description`
rich_editing	A string for whether to enable the rich editor or not. False if not empty.	(none)
user_registered	The date the user registered. Format is Y-m-d H:i:s.	(none)
role	A string used to set the user's role.	(none)
jabber	User's Jabber account.	(none)
aim	User's AOL IM account.	(none)
yim	User's Yahoo IM account.	(none)

When performing an update operation, user_pass should be the hashed password and not the plain text password.

If you pass an ID, the user with that ID will be updated. If there is no ID, a new user will be created.

Change Log

3.5.0: Now accepts stdClass or WP_User object
Since: 2.0.0

Source File

As of 3.1 wp_insert_user() is located in wp-includes/user.php.

WordPress.org

Codex

Function Reference/wp insert user

Contents