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:

functions.php
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.

  1. WooCommerce icon WooCommerce7+ million installs apply_filters( 'illegal_user_logins', array() ) includes/wc-user-functions.php:263
  2. MainWP Child icon MainWP Child700,000+ installs apply_filters( 'illegal_user_logins', array() ) class/class-mainwp-child-users.php:451
  3. Ultimate Member icon Ultimate Member200,000+ installs apply_filters( 'illegal_user_logins', array() ) includes/core/um-actions-form.php:80
  4. Advanced Custom Fields: Extended icon Advanced Custom Fields: Extended100,000+ installs apply_filters( 'illegal_user_logins', array() ) includes/modules/form/module-form-action-user.php:454
  5. BuddyPress icon BuddyPress90,000+ installs apply_filters( 'illegal_user_logins', array() ) bp-members/bp-members-functions.php:1567
  6. Import and export users and customers icon Import and export users and customers70,000+ installs apply_filters( 'illegal_user_logins', array() ) classes/wizard.php:1289
  7. LearnPress icon LearnPress60,000+ installs apply_filters( 'illegal_user_logins', array() ) inc/jwt/rest-api/version1/class-lp-rest-users-v1-controller.php:1203
  8. Username Changer icon Username Changer40,000+ installs apply_filters( 'illegal_user_logins', array() ) includes/admin/actions.php:58
  9. Login & Register Customizer icon Login & Register Customizer30,000+ installs apply_filters( 'illegal_user_logins', array() ) includes/class-xoo-el-form-handler.php:609
  10. wpForo Forum icon wpForo Forum20,000+ installs apply_filters( 'illegal_user_logins', [] ) classes/Members.php:469
  11. FluentAuth icon FluentAuth10,000+ installs apply_filters( 'illegal_user_logins', array() ) app/Services/AuthService.php:520
  12. Noptin icon Noptin10,000+ installs apply_filters( 'illegal_user_logins', array() ) build/Objects/Users.php:178
  13. LifterLMS icon LifterLMS10,000+ installs apply_filters( 'illegal_user_logins', array() ) libraries/lifterlms-rest/includes/abstracts/class-llms-rest-users-controller.php:691
  14. LA-Studio Element Kit for Elementor icon LA-Studio Element Kit for Elementor10,000+ installs apply_filters( 'illegal_user_logins', array() ) includes/class-integration.php:907
  15. MotoPress Hotel Booking icon MotoPress Hotel Booking10,000+ installs apply_filters( 'illegal_user_logins', array() ) includes/users-and-roles/user.php:162
  16. FluentCart icon FluentCart10,000+ installs apply_filters( 'illegal_user_logins', array() ) app/Services/AuthService.php:237
  17. FluentCommunity icon FluentCommunity8,000+ installs apply_filters( 'illegal_user_logins', array() ) Modules/Auth/AuthHelper.php:31
  18. Classified Listing icon Classified Listing8,000+ installs apply_filters( 'illegal_user_logins', [] ) app/Helpers/Functions.php:4411
  19. Masteriyo LMS icon Masteriyo LMS6,000+ installs apply_filters( 'illegal_user_logins', array() ) includes/Helper/core.php:2544
  20. Payment forms, Buy now buttons, and Invoicing System icon Payment forms, Buy now buttons, and Invoicing System5,000+ installs apply_filters( 'illegal_user_logins', array() ) includes/user-functions.php:178
  21. Change Username icon Change Username4,000+ installs apply_filters( 'illegal_user_logins', [] ) src/functions.php:75
  22. WPSSO Core icon WPSSO Core4,000+ installs apply_filters( 'illegal_user_logins', array() ) lib/users/add-person.php:282
  23. WPMobile.App icon WPMobile.App3,000+ installs apply_filters( 'illegal_user_logins', array() ) inc/functions/shortcodes.php:110
  24. FluentAffiliate icon FluentAffiliate2,000+ installs apply_filters( 'illegal_user_logins', [] ) app/Modules/Auth/AuthHelper.php:48
  25. MotoPress Appointment Booking icon MotoPress Appointment Booking2,000+ installs apply_filters( 'illegal_user_logins', array() ) includes/rest/controllers/motopress/appointment/v1/CustomersRestController.php:136
  26. WP Edit Username icon WP Edit Username2,000+ installs apply_filters( 'illegal_user_logins', array() ) admin/class-wp-edit-username-admin.php:311
  27. Listdom: AI-powered Business Directory with Classifieds Ads Listings icon Listdom: AI-powered Business Directory with Classifieds Ads Listings1,000+ installs apply_filters( 'illegal_user_logins', [] ) app/includes/user.php:161
  28. BetterShield icon BetterShield1,000+ installs apply_filters( 'illegal_user_logins', array() ) src/Fixes/AdminUsername.php:109
  29. easyReservations icon easyReservations700+ installs apply_filters( 'illegal_user_logins', array() ) includes/er-user-functions.php:194
  30. Creator LMS icon Creator LMS100+ installs apply_filters( 'illegal_user_logins', array() ) packages/e-commerce/includes/Utility/student-functions.php:152
  31. Contact Manager icon Contact Manager100+ installs apply_filters( 'illegal_user_logins', array() ) includes/add-message.php:207
  32. Ultimate Multisite icon Ultimate Multisite100+ installs apply_filters( 'illegal_user_logins', [] ) inc/functions/customer.php:544
  33. Checkout Gateway for Paddle icon Checkout Gateway for Paddle80+ installs apply_filters( 'illegal_user_logins', array() ) includes/User.php:255
  34. PeproDev Ultimate Profile Solutions icon PeproDev Ultimate Profile Solutions70+ installs apply_filters( 'illegal_user_logins', array() ) login/login.php:2449
  35. Nelio Forms icon Nelio Forms50+ installs apply_filters( 'illegal_user_logins', array() ) includes/fields/text.php:52
  36. SpaceBay icon SpaceBay20+ installs apply_filters( 'illegal_user_logins', array() ) includes/Exchange/Import/PlanUsers.php:306
  37. Brozzme Change Username icon Brozzme Change Username20+ installs apply_filters( 'illegal_user_logins', array() ) includes/brozzme_change_username_profils.php:86
  38. All-in-One Utilities icon All-in-One Utilities20+ installs apply_filters( 'illegal_user_logins', array() ) src/Modules/UsernameUpdater/Validator.php:83
  39. WPdrift IO icon WPdrift IO10+ installs apply_filters( 'illegal_user_logins', array() ) includes/rest-api/class-wpdrift-rest-users-controller.php:1105
  40. SmartUsername icon SmartUsername10+ installs apply_filters( 'illegal_user_logins', array() ) includes/class-smartusername-renamer.php:84
  41. Easy Events Manager icon Easy Events Manager10+ installs apply_filters( 'illegal_user_logins', array() ) includes/functions.php:1173
  42. MarketEngine icon MarketEngine10+ installs apply_filters( 'illegal_user_logins', array() ) includes/handle-authentication/class-me-authentication.php:149
  43. PowerSuite Modular Admin Toolkit icon PowerSuite Modular Admin Toolkit10+ installs apply_filters( 'illegal_user_logins', [] ) modules/block-usernames/module.php:145
  44. WPZOOM User History icon WPZOOM User History10+ installs apply_filters( 'illegal_user_logins', [] ) includes/class-admin.php:856
  45. Tsjippy Embed A Page icon Tsjippy Embed A PageFewer than 10 installs apply_filters( 'illegal_user_logins', array() ) shared-functionality/php/user_accounts.php:44
  46. Tsjippy Default Pictures icon Tsjippy Default PicturesFewer than 10 installs apply_filters( 'illegal_user_logins', array() ) shared-functionality/php/user_accounts.php:44
  47. WP AAI@EduHr Auth icon WP AAI@EduHr AuthFewer than 10 installs apply_filters( 'illegal_user_logins', array() ) class-wp-aaieduhr-bootstrap.php:312
  48. Tsjippy Daily Message icon Tsjippy Daily MessageFewer than 10 installs apply_filters( 'illegal_user_logins', array() ) shared-functionality/php/user_accounts.php:44
  49. Hatch Connect icon Hatch ConnectFewer than 10 installs apply_filters( 'illegal_user_logins', array() ) includes/class-auth.php:279
  50. Tsjippy Comments icon Tsjippy CommentsFewer than 10 installs apply_filters( 'illegal_user_logins', array() ) shared-functionality/php/user_accounts.php:44
  51. Tsjippy Captcha icon Tsjippy CaptchaFewer than 10 installs apply_filters( 'illegal_user_logins', array() ) shared-functionality/php/user_accounts.php:44
  52. Convert Username to Customer Code for Woocommerce icon Convert Username to Customer Code for WoocommerceFewer than 10 installs apply_filters( 'illegal_user_logins', array() ) src/cutccfw-change-username.php:59
  53. NexaBoard icon NexaBoardFewer than 10 installs apply_filters( 'illegal_user_logins', array() ) includes/class-nexaboard-frontend.php:2487
  54. Teydea Site Assistant icon Teydea Site AssistantFewer than 10 installs apply_filters( 'illegal_user_logins', [] ) src/modules/cards-security/internal/class-admin-username-applier.php:231
  55. CAJE Course Builder icon CAJE Course BuilderFewer than 10 installs apply_filters( 'illegal_user_logins', array() ) includes/Frontend/Signup.php:244
  56. EffortLess Multisite Change Username icon EffortLess Multisite Change UsernameFewer than 10 installs apply_filters( 'illegal_user_logins', array() ) includes/class-elmcu-change-username.php:693
  57. Hubu Panel icon Hubu PanelFewer than 10 installs apply_filters( 'illegal_user_logins', array() ) includes/modules/authentication/application/class-username-generator.php:329
  58. Fieldwren icon FieldwrenFewer than 10 installs apply_filters( 'illegal_user_logins', array() ) modules/class-user-registration.php:160
  59. Login with Frica ID icon Login with Frica IDFewer than 10 installs apply_filters( 'illegal_user_logins', [] ) includes/class-plugin.php:273
  60. Togra ContentFlow icon Togra ContentFlowFewer than 10 installs apply_filters( 'illegal_user_logins', array() ) includes/actions/class-action-create-user.php:205
  61. GreenScript PressBot icon GreenScript PressBotFewer than 10 installs apply_filters( 'illegal_user_logins', array() ) includes/Services/UsernameChanger.php:261
  62. Polanger Dating for WordPress icon Polanger Dating for WordPressFewer than 10 installs apply_filters( 'illegal_user_logins', array() ) src/Accounts/Auth_Service.php:96
  63. atshift Members icon atshift MembersFewer than 10 installs apply_filters( 'illegal_user_logins', [] ) includes/class-registration.php:127
  64. Gutenberg Login Page Customizer icon 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.