Enhanced User Search
Enhanced User Search: Effortlessly Find Your Users
Struggling to locate a specific user in the WordPress administration area? The standard user search can make it difficult to find people when you only know their name, phone number, company or another profile detail.
Enhanced User Search expands the existing WordPress Users search so you can find users using names, account details and safe custom user fields—all from the familiar Users screen.
Why use Enhanced User Search?
- Find users more easily: Locate users even when you do not remember their exact username or email address.
- Save administration time: Search several types of user information from one search box.
- Improve accuracy: Use complete names and multiple terms to narrow the results.
- Manage larger user lists: Find specific accounts more efficiently on membership, e-commerce and Multisite installations.
- No setup required: Activate the plugin and continue using the existing WordPress user search.
Key features
- Search first names, last names, display names, usernames and email addresses.
- Search user IDs and safe custom user fields.
- Search complete names even when first and last names are stored separately.
- Use automatic multi-word AND matching.
- Use explicit AND and OR search operators.
- Automatically exclude common security-sensitive and internal fields.
- Avoid duplicate results and pagination problems on Multisite installations.
- Work directly inside the existing WordPress Users screen.
- Use the plugin immediately without a settings page.
Who should use Enhanced User Search?
This plugin is useful for anyone who manages WordPress users, especially:
- Websites with large user lists: Find a specific account among many users.
- Membership websites: Search membership numbers and custom profile information.
- WooCommerce stores: Find customers using safe billing details such as phone numbers or company names.
- WordPress Multisite networks: Search users while preserving WordPress site and network restrictions.
- Customer portals: Search customer references, account identifiers and other safe profile fields.
- Developers and administrators: Improve user management without replacing the standard WordPress interface.
Search using more user information
Administrators can search by:
- First name
- Last name
- Display name
- Username
- Email address
- User ID
- Safe custom user fields
Search complete names
Multiple words use AND matching automatically.
For example, consider a user with:
- First name: Charles
- Last name: King
- Display name: Chuck
The following searches can find the user:
CharlesKingCharles KingKing CharlesCharles AND KingCharles OR Chuck
Each word can match a different searchable field. This means Charles King can find the user even when the display name is Chuck.
Use AND and OR searches
Use AND when every search term must match:
Charles AND King
Use OR when either search term can match:
Charles OR Chuck
The AND and OR operators are case-insensitive.
Automatic custom-field search
Safe custom user fields are searched automatically. There is no settings page and administrators do not need to select individual fields.
Searchable information can include:
- Phone numbers
- Company names
- Membership numbers
- Customer references
- Account identifiers
- Custom profile information
- Safe WooCommerce billing information
This makes the plugin useful for membership sites, online stores, customer portals and websites with custom registration fields.
Security-conscious searching
Common sensitive and internal fields are excluded automatically, including fields related to:
- Passwords and password hashes
- WordPress sessions
- Application passwords
- Authentication and access tokens
- API keys and secrets
- Private keys
- Capabilities and user levels
- Nonces and cookies
- OTP and two-factor authentication
- Recovery and backup codes
- Internal WordPress interface preferences
Custom-field values are used only to find matching users. The plugin does not display those values on the Users screen.
WordPress Multisite support
Enhanced User Search supports WordPress Multisite.
The plugin avoids joining user-meta records directly to the main user query. This prevents duplicate users and incorrect pagination when multiple custom fields match the same user.
Lightweight WordPress integration
The plugin uses the existing WordPress user-search interface.
It does not:
- Replace the Users screen
- Add a separate user-management area
- Add a settings page
- Modify user information
- Display custom-field values
- Send information to external services
- Track administrators or users
Developer Notes
Developers can extend the list of exact user-meta keys excluded from search with the eus_excluded_meta_keys filter:
add_filter(
'eus_excluded_meta_keys',
function ( $keys ) {
$keys[] = 'private_customer_reference';
return $keys;
}
);
Developers can exclude keys containing a term with the eus_excluded_meta_key_fragments filter:
add_filter(
'eus_excluded_meta_key_fragments',
function ( $fragments ) {
$fragments[] = 'private_code';
return $fragments;
}
);
Developers can exclude keys beginning with a value with the eus_excluded_meta_key_prefixes filter:
add_filter(
'eus_excluded_meta_key_prefixes',
function ( $prefixes ) {
$prefixes[] = 'internal_';
return $prefixes;
}
);
Add these filters through a custom plugin, child theme or must-use plugin.
