Home » Functions » username_exists

The WordPress function username_exists is a handy tool for checking if a given username already exists in the WordPress database. It can be used to validate username availability during the registration process or to prevent duplicate usernames.

The username_exists function takes a single parameter, which is the username you want to check. It then queries the WordPress database to see if a user with that username already exists. If a user is found with the specified username, the function returns the user’s ID. If no user is found, the function returns false.

Here’s an example of how you can use the username_exists function in a registration form to validate the availability of a chosen username:

$username = $_POST['username'];

if (username_exists($username)) {
    echo 'Sorry, this username is already taken.';
} else {
    echo 'Congratulations, this username is available.';

In this example, the value submitted via the $_POST superglobal is assigned to the $username variable. The username_exists function is then used to check if this username already exists in the WordPress database. If it does, an error message is displayed; otherwise, a success message is shown. This helps ensure that each user has a unique username.

It’s important to note that the username_exists function does not perform any sanitization or validation of the username itself. It simply checks if the username exists in the database. Therefore, it’s always recommended to sanitize and validate user input before using it in any database queries or operations.

In conclusion, the username_exists function is a powerful tool for checking the availability of a username in WordPress. It can be used to provide real-time feedback to users during registration or to prevent duplicate usernames, enhancing the overall user experience.

Learn More on

Register an account to save your snippets or go Pro to get more features.