Change WordPress Username by Mobile Number | User Login

Change Username (Mobile Number) for WordPress

Changing a WordPress username is not normally possible through the standard WordPress dashboard. This can become a real problem for websites that use a mobile phone number as the username, especially membership websites, online marketplaces, directories, and WooCommerce stores.

The Change Username (Mobile Number) for WordPress plugin provides a simple and secure solution for administrators. It allows you to find any existing WordPress user, update their username to a new mobile number, validate the new number, prevent duplicate usernames, and automatically invalidate the user's active sessions.

Instead of editing the WordPress database manually or using complicated database queries, administrators can manage username changes directly from the WordPress dashboard.

Why Change WordPress Usernames?

WordPress does not provide a built-in option for changing a user's user_login after the account has been created. This limitation is especially inconvenient for websites that use phone numbers as usernames.

For example, a customer may register with an incorrect mobile number, change their phone number later, or need their account migrated to a new number. In these situations, manually modifying database records can be risky and may require technical knowledge.

This plugin makes the process much easier. Administrators can search for an existing customer, select the correct account, enter the new mobile number, and change the username in just a few steps.

Designed for Mobile-Based WordPress Websites

The plugin is particularly useful for websites where the customer's mobile phone number is also used as their WordPress username.

This setup is common for membership websites, marketplaces, classified directories, WooCommerce stores, and websites that use SMS-based registration or login systems.

Instead of creating a complicated workflow for customer support, site administrators can use a dedicated dashboard tool to safely correct or update usernames whenever necessary.

Key Features

Live AJAX User Search

Find users quickly without reloading the WordPress dashboard. Start typing a username, display name, or part of a mobile number and the plugin displays matching accounts instantly.

Simple User Selection

Search results make it easier to identify the correct account before making a change. This reduces the risk of accidentally modifying the wrong user.

Mobile Number Validation

The plugin validates the new username before saving it. By default, the validation pattern is designed for Iranian mobile numbers in the 09XXXXXXXXX format.

The validation pattern can also be customized for other countries using the available developer filter.

Duplicate Username Protection

Before changing the username, the plugin checks whether the new mobile number is already associated with another WordPress account.

This prevents duplicate usernames and helps maintain clean and reliable user data.

Native WordPress Admin Integration

The plugin integrates directly into the WordPress dashboard under:

Users → Change Username

There is no unnecessary top-level menu or complicated settings interface. The feature is available exactly where administrators expect to find user-management tools.

Automatic Session Invalidation

Security is an important part of changing account credentials. After a successful username change, the user's existing login sessions are automatically invalidated.

As a result, the user will need to log in again using the new username or mobile number.

Developer-Friendly Hooks

Developers can extend the plugin without modifying its core files.

The cum_mobile_regex filter allows developers to customize the mobile number validation pattern for different countries and phone-number formats.

The cum_after_username_changed action is triggered after a successful username change and can be used for additional integrations such as SMS notifications, activity logging, CRM synchronization, or custom workflows.

Lightweight and Dependency-Free

The plugin is designed to remain lightweight and efficient. It does not depend on external JavaScript libraries or unnecessary frameworks.

It uses native WordPress APIs, including AJAX, nonces, capability checks, sanitization, and escaping.

Security-Focused Architecture

Security is built into the username-change process. Requests are protected with WordPress nonce verification, capability checks, sanitized input, and escaped output.

Only users with the appropriate edit_users capability can perform username changes.

Who Can Benefit from This Plugin?

Membership Websites: Perfect for websites where customers register and log in using their mobile phone numbers.

Online Marketplaces: Useful for marketplaces where vendors or customers use mobile numbers as account usernames.

WooCommerce Stores: Store administrators can correct a customer's mobile-based username without directly modifying database records.

Classified and Directory Websites: Ideal for platforms where phone numbers are used as the primary account identifier.

SMS Login Systems: A useful administration tool for websites that rely on SMS verification and phone-based authentication.

Customer Support Teams: Support staff can correct a customer's username without requiring direct database access.

How Does It Work?

Using the plugin is straightforward.

1. Log in to your WordPress dashboard.
2. Navigate to Users → Change Username.
3. Search for the customer using their current username, mobile number, or display name.
4. Select the correct account from the search results.
5. Enter the new mobile number.
6. Click Change Username.
7. The plugin validates the new number and checks for duplicates.
8. After a successful update, existing sessions for that user are invalidated.

The entire process can be completed directly from the WordPress admin area without using phpMyAdmin or manually editing database tables.

Safe Alternative to Manual Database Editing

Changing user_login manually in the database can be risky, particularly on a production website. An incorrect query or modification can result in inconsistent account information or unexpected login problems.

This plugin provides a controlled WordPress-based workflow that handles the username update while keeping the rest of the user's WordPress account intact.

User roles, posts, capabilities, orders, and other account-related data remain associated with the same WordPress user account.

Flexible Mobile Number Validation

Although the default validation targets Iranian mobile numbers such as 09XXXXXXXXX, the plugin is not limited to Iran.

Developers can use the cum_mobile_regex filter to adapt the validation rules to the phone-number format required by their website.

This makes the plugin suitable for international WordPress websites that use phone numbers as usernames.

Requirements

• WordPress 6.9 or higher
• PHP 7.4 or higher
• Administrator or user-management permissions with the edit_users capability

Important Notes

WordPress intentionally does not provide a standard user-update function for changing the user_login value. This plugin handles the username update at the database level while taking care of related caches and user-session security.

The plugin is intended for administrators and authorized support staff who need a reliable way to correct or update mobile-based WordPress usernames.

Whether a customer entered the wrong number during registration, changed their phone number, or needs their account migrated to a new mobile number, Change Username (Mobile Number) for WordPress provides a practical solution without requiring direct database manipulation.

Conclusion

If your WordPress website uses mobile phone numbers as usernames, changing an existing username should not require database access or complicated technical procedures.

Change Username (Mobile Number) for WordPress provides a focused administration tool for searching users, validating new mobile numbers, preventing duplicates, updating usernames, and protecting active sessions.

It is lightweight, secure, developer-friendly, and designed specifically for WordPress websites that rely on mobile-based user registration and authentication.