WordPress filter hook · part of WordPress core
illegal_user_logins
A WordPress core filter that 64 plugins also fire themselves, running on 8.4M+ sites between them.
“WordPress 4.4 - filters the list of blocked usernames.”
How to use illegal_user_logins
It's a filter: your callback receives the value, and must return the (changed) value.
Add this to your theme's functions.php or a small custom plugin:
add_filter( 'illegal_user_logins', function( $value ) {
// Change $value here.
return $value;
}, 10, 1 );Argument names come from WooCommerce's source. Other plugins may pass different values: check the call in the plugin you're targeting below.
This hook is fired by WordPress core too. Official reference on developer.wordpress.org →
64 plugins that fire illegal_user_logins
Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.
-
WooCommerce7+ million installs
apply_filters( 'illegal_user_logins', array() )includes/wc-user-functions.php:263 -
MainWP Child700,000+ installs
apply_filters( 'illegal_user_logins', array() )class/class-mainwp-child-users.php:451 -
Ultimate Member200,000+ installs
apply_filters( 'illegal_user_logins', array() )includes/core/um-actions-form.php:80 -
Advanced Custom Fields: Extended100,000+ installs
apply_filters( 'illegal_user_logins', array() )includes/modules/form/module-form-action-user.php:454 -
BuddyPress90,000+ installs
apply_filters( 'illegal_user_logins', array() )bp-members/bp-members-functions.php:1567 -
Import and export users and customers70,000+ installs
apply_filters( 'illegal_user_logins', array() )classes/wizard.php:1289 -
LearnPress60,000+ installs
apply_filters( 'illegal_user_logins', array() )inc/jwt/rest-api/version1/class-lp-rest-users-v1-controller.php:1203 -
Username Changer40,000+ installs
apply_filters( 'illegal_user_logins', array() )includes/admin/actions.php:58 -
Login & Register Customizer30,000+ installs
apply_filters( 'illegal_user_logins', array() )includes/class-xoo-el-form-handler.php:609 -
wpForo Forum20,000+ installs
apply_filters( 'illegal_user_logins', [] )classes/Members.php:469 -
FluentAuth10,000+ installs
apply_filters( 'illegal_user_logins', array() )app/Services/AuthService.php:520 -
Noptin10,000+ installs
apply_filters( 'illegal_user_logins', array() )build/Objects/Users.php:178 -
LifterLMS10,000+ installs
apply_filters( 'illegal_user_logins', array() )libraries/lifterlms-rest/includes/abstracts/class-llms-rest-users-controller.php:691 -
LA-Studio Element Kit for Elementor10,000+ installs
apply_filters( 'illegal_user_logins', array() )includes/class-integration.php:907 -
MotoPress Hotel Booking10,000+ installs
apply_filters( 'illegal_user_logins', array() )includes/users-and-roles/user.php:162 -
FluentCart10,000+ installs
apply_filters( 'illegal_user_logins', array() )app/Services/AuthService.php:237 -
FluentCommunity8,000+ installs
apply_filters( 'illegal_user_logins', array() )Modules/Auth/AuthHelper.php:31 -
Classified Listing8,000+ installs
apply_filters( 'illegal_user_logins', [] )app/Helpers/Functions.php:4411 -
Masteriyo LMS6,000+ installs
apply_filters( 'illegal_user_logins', array() )includes/Helper/core.php:2544 -
Payment forms, Buy now buttons, and Invoicing System5,000+ installs
apply_filters( 'illegal_user_logins', array() )includes/user-functions.php:178 -
Change Username4,000+ installs
apply_filters( 'illegal_user_logins', [] )src/functions.php:75 -
WPSSO Core4,000+ installs
apply_filters( 'illegal_user_logins', array() )lib/users/add-person.php:282 -
WPMobile.App3,000+ installs
apply_filters( 'illegal_user_logins', array() )inc/functions/shortcodes.php:110 -
FluentAffiliate2,000+ installs
apply_filters( 'illegal_user_logins', [] )app/Modules/Auth/AuthHelper.php:48 -
MotoPress Appointment Booking2,000+ installs
apply_filters( 'illegal_user_logins', array() )includes/rest/controllers/motopress/appointment/v1/CustomersRestController.php:136 -
WP Edit Username2,000+ installs
apply_filters( 'illegal_user_logins', array() )admin/class-wp-edit-username-admin.php:311 -
Listdom: AI-powered Business Directory with Classifieds Ads Listings1,000+ installs
apply_filters( 'illegal_user_logins', [] )app/includes/user.php:161 -
BetterShield1,000+ installs
apply_filters( 'illegal_user_logins', array() )src/Fixes/AdminUsername.php:109 -
easyReservations700+ installs
apply_filters( 'illegal_user_logins', array() )includes/er-user-functions.php:194 -
Creator LMS100+ installs
apply_filters( 'illegal_user_logins', array() )packages/e-commerce/includes/Utility/student-functions.php:152 -
Contact Manager100+ installs
apply_filters( 'illegal_user_logins', array() )includes/add-message.php:207 -
Ultimate Multisite100+ installs
apply_filters( 'illegal_user_logins', [] )inc/functions/customer.php:544 -
Checkout Gateway for Paddle80+ installs
apply_filters( 'illegal_user_logins', array() )includes/User.php:255 -
PeproDev Ultimate Profile Solutions70+ installs
apply_filters( 'illegal_user_logins', array() )login/login.php:2449 -
Nelio Forms50+ installs
apply_filters( 'illegal_user_logins', array() )includes/fields/text.php:52 -
SpaceBay20+ installs
apply_filters( 'illegal_user_logins', array() )includes/Exchange/Import/PlanUsers.php:306 -
Brozzme Change Username20+ installs
apply_filters( 'illegal_user_logins', array() )includes/brozzme_change_username_profils.php:86 -
All-in-One Utilities20+ installs
apply_filters( 'illegal_user_logins', array() )src/Modules/UsernameUpdater/Validator.php:83 -
WPdrift IO10+ installs
apply_filters( 'illegal_user_logins', array() )includes/rest-api/class-wpdrift-rest-users-controller.php:1105 -
SmartUsername10+ installs
apply_filters( 'illegal_user_logins', array() )includes/class-smartusername-renamer.php:84 -
Easy Events Manager10+ installs
apply_filters( 'illegal_user_logins', array() )includes/functions.php:1173 -
MarketEngine10+ installs
apply_filters( 'illegal_user_logins', array() )includes/handle-authentication/class-me-authentication.php:149 -
PowerSuite Modular Admin Toolkit10+ installs
apply_filters( 'illegal_user_logins', [] )modules/block-usernames/module.php:145 -
WPZOOM User History10+ installs
apply_filters( 'illegal_user_logins', [] )includes/class-admin.php:856 -
Tsjippy Embed A PageFewer than 10 installs
apply_filters( 'illegal_user_logins', array() )shared-functionality/php/user_accounts.php:44 -
Tsjippy Default PicturesFewer than 10 installs
apply_filters( 'illegal_user_logins', array() )shared-functionality/php/user_accounts.php:44 -
WP AAI@EduHr AuthFewer than 10 installs
apply_filters( 'illegal_user_logins', array() )class-wp-aaieduhr-bootstrap.php:312 -
Tsjippy Daily MessageFewer than 10 installs
apply_filters( 'illegal_user_logins', array() )shared-functionality/php/user_accounts.php:44 -
Hatch ConnectFewer than 10 installs
apply_filters( 'illegal_user_logins', array() )includes/class-auth.php:279 -
Tsjippy CommentsFewer than 10 installs
apply_filters( 'illegal_user_logins', array() )shared-functionality/php/user_accounts.php:44 -
Tsjippy CaptchaFewer than 10 installs
apply_filters( 'illegal_user_logins', array() )shared-functionality/php/user_accounts.php:44 -
Convert Username to Customer Code for WoocommerceFewer than 10 installs
apply_filters( 'illegal_user_logins', array() )src/cutccfw-change-username.php:59 -
NexaBoardFewer than 10 installs
apply_filters( 'illegal_user_logins', array() )includes/class-nexaboard-frontend.php:2487 -
Teydea Site AssistantFewer than 10 installs
apply_filters( 'illegal_user_logins', [] )src/modules/cards-security/internal/class-admin-username-applier.php:231 -
CAJE Course BuilderFewer than 10 installs
apply_filters( 'illegal_user_logins', array() )includes/Frontend/Signup.php:244 -
EffortLess Multisite Change UsernameFewer than 10 installs
apply_filters( 'illegal_user_logins', array() )includes/class-elmcu-change-username.php:693 -
Hubu PanelFewer than 10 installs
apply_filters( 'illegal_user_logins', array() )includes/modules/authentication/application/class-username-generator.php:329 -
FieldwrenFewer than 10 installs
apply_filters( 'illegal_user_logins', array() )modules/class-user-registration.php:160 -
Login with Frica IDFewer than 10 installs
apply_filters( 'illegal_user_logins', [] )includes/class-plugin.php:273 -
Togra ContentFlowFewer than 10 installs
apply_filters( 'illegal_user_logins', array() )includes/actions/class-action-create-user.php:205 -
GreenScript PressBotFewer than 10 installs
apply_filters( 'illegal_user_logins', array() )includes/Services/UsernameChanger.php:261 -
Polanger Dating for WordPressFewer than 10 installs
apply_filters( 'illegal_user_logins', array() )src/Accounts/Auth_Service.php:96 -
atshift MembersFewer than 10 installs
apply_filters( 'illegal_user_logins', [] )includes/class-registration.php:127 -
Gutenberg Login Page CustomizerFewer than 10 installs
apply_filters( 'illegal_user_logins', [] )blocks/register/block.php:527
Need a customisation built on this hook?
Tell us what you want to change and which plugin it's for. We'll write it, test it and send it back as a small plugin.