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

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

Contents

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.

Top ↑

See also

Top ↑

Parameters

$username string Required
The user's username.
$password string Required
The user's password.
$email string Optional
The user's email.

Default: ''

Top ↑

Return

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

Top ↑

Source

File: wp-includes/user.php. View all references 

function wp_create_user( $username, $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 on Trac View on GitHub

Top ↑

Top ↑

Uses

Uses
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.

Top ↑

Changelog

Changelog
Version Description
2.0.0 Introduced.

Top ↑

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 —

    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' );
}

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