wp_create_user() – Function | Developer.WordPress.org

Provides a simpler way of inserting a user into the database.

Description

Creates a new user with just the username, password, and email. For more complex user creation use wp_insert_user() to specify more information.

Parameters

$usernamestringrequired: The user’s username.
$passwordstringrequired: The user’s password.
$emailstringoptional: The user’s email.
Default:''

Return

int|WP_Error The newly created user’s ID or a WP_Error object if the user could not be created.

Source

function wp_create_user(
	$username,
	#[\SensitiveParameter]
	$password,
	$email = ''
) {
	$user_login = wp_slash( $username );
	$user_email = wp_slash( $email );
	$user_pass  = $password;

	$userdata = compact( 'user_login', 'user_email', 'user_pass' );
	return wp_insert_user( $userdata );
}

View all references View on Trac View on GitHub

Uses	Description
wp_insert_user()`wp-includes/user.php`	Inserts a user into the database.
wp_slash()`wp-includes/formatting.php`	Adds slashes to a string or recursively adds slashes to strings within an array.

Used by	Description
wp_install()`wp-admin/includes/upgrade.php`	Installs the site.
create_user()`wp-includes/deprecated.php`	An alias of wp_create_user() .
register_new_user()`wp-includes/user.php`	Handles registering a new user.
wpmu_create_user()`wp-includes/ms-functions.php`	Creates a user.

Changelog

Version	Description
2.0.0	Introduced.

User Contributed Notes

Codex 9 years ago

Basic Example

As used in wp-admin/upgrade-functions.php:

$user_id = username_exists( $user_name );

if ( ! $user_id && false == email_exists( $user_email ) ) {
	$random_password = wp_generate_password( $length = 12, $include_standard_special_chars = false );
	$user_id = wp_create_user( $user_name, $random_password, $user_email );
} else {
	$random_password = __( 'User already exists.  Password inherited.', 'textdomain' );
}

Skip to note 4 content

afrojanoon 3 years 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

Just a note:
As mentioned in the wp_insert_user() function arguments, the password expected here is plain text password.
user_pass (string): The plain-text user password.

Log in to add feedback

wp_create_user( string $username, string $password, string $email = '' ): int|WP_Error

In this article