WordPress filter hook

login_messages

Fired by 35 WordPress plugins, running on 5M+ sites between them.

“Filters instructional messages displayed above the login form.”

How to use login_messages

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( 'login_messages', function( $messages ) {
	// Change $messages here.
	return $messages;
}, 10, 1 );

Argument names come from Really Simple Security's source. Other plugins may pass different values: check the call in the plugin you're targeting below.

35 plugins that fire login_messages

Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.

  1. Really Simple Security icon Really Simple Security3+ million installs apply_filters( 'login_messages', $messages ) security/wordpress/two-fa/function-login-header.php:248
  2. Kadence Security icon Kadence Security700,000+ installs apply_filters( 'login_messages', $messages ) core/lib/includes/function.login-header.php:195
  3. Nextend Social Login and Register icon Nextend Social Login and Register200,000+ installs apply_filters( 'login_messages', $messages ) includes/compat-wp-login.php:274
  4. LoginPress icon LoginPress200,000+ installs apply_filters( 'login_messages', $messages ) include/template-loginpress.php:254
  5. CloudSecure WP Security icon CloudSecure WP Security200,000+ installs apply_filters( 'login_messages', $message ) modules/two-factor-authentication.php:202
  6. Two Factor icon Two Factor100,000+ installs apply_filters( 'login_messages', $messages ) includes/function.login-header.php:281
  7. WP 2FA icon WP 2FA100,000+ installs apply_filters( 'login_messages', $messages ) includes/functions/login-header.php:204
  8. Hide My WP Ghost icon Hide My WP Ghost100,000+ installs apply_filters( 'login_messages', $messages ) view/wplogin/header.php:354
  9. Defender Security icon Defender Security80,000+ installs apply_filters( 'login_messages', $messages ) src/view/two-fa/otp.php:240
  10. Titan Anti-spam & Security icon Titan Anti-spam & Security50,000+ installs apply_filters( 'login_messages', $messages ) includes/tweaks/password-requirements/login-interstitial/functions-login-header.php:219
  11. WP Hide & Security Enhancer icon WP Hide & Security Enhancer50,000+ installs apply_filters( 'login_messages', $messages ) modules/components/login_2fa_template_login_header.php:280
  12. Ultimate Dashboard icon Ultimate Dashboard50,000+ installs apply_filters( 'login_messages', $messages ) modules/login-customizer/templates/udb-login-page.php:228
  13. Theme My Login icon Theme My Login50,000+ installs apply_filters( 'login_messages', implode( "</li>\n<li class=\"tml-message\">", $messages ) ) includes/class-theme-my-login-form.php:430
  14. SecuPress with Simple SSL icon SecuPress with Simple SSL40,000+ installs apply_filters( 'login_messages', $messages ) free/functions/formatting.php:301
  15. Shield Security icon Shield Security30,000+ installs apply_filters( 'login_messages', $messages ) src/ActionRouter/Actions/Render/FullPage/Mfa/Components/WpLoginReplicaHeader.php:177
  16. Loginfy icon Loginfy2,000+ installs apply_filters( 'login_messages', $messages ) Inc/Core/Inc/loginfy-login-template.php:267
  17. Affiliates icon Affiliates2,000+ installs apply_filters( 'login_messages', implode( '<br />', $messages ) ) lib/core/class-affiliates-registration.php:414
  18. School Management System icon School Management System1,000+ installs apply_filters( 'login_messages', $messages ) wpsp-school-login.php:189
  19. Login Page Customizer icon Login Page Customizer1,000+ installs apply_filters( 'login_messages', $messages ) login-page-customizer/customize/template-lpc-custom-login-page.php:228
  20. CLP icon CLP600+ installs apply_filters( 'login_messages', $messages ) includes/customizer-login-template.php:182
  21. SecSign icon SecSign200+ installs apply_filters( 'login_messages', $messages ) secsignid_login.php:513
  22. Admin Optimizer icon Admin Optimizer100+ installs apply_filters( 'login_messages', $messages ) modules/2fa/includes/wp-2fa-login.php:278
  23. Fuerte-WP icon Fuerte-WP80+ installs apply_filters( 'login_messages', $messages ) includes/two-factor/includes/function.login-header.php:283
  24. BAAP Mobile Version icon BAAP Mobile Version30+ installs apply_filters( 'login_messages', $messages ) plugins/wpmp_switcher/pages/mobile_login.php:59
  25. SPIRALセキュアセッションマネージャー icon SPIRALセキュアセッションマネージャー30+ installs apply_filters( 'login_messages', $messages ) include/class-spiral-secure-session-manager-template.php:308
  26. Registration Page Shortcut icon Registration Page Shortcut10+ installs apply_filters( 'login_messages', $messages ) registration_page_shortcut.php:121
  27. WP Front End Login icon WP Front End Login10+ installs apply_filters( 'login_messages', $this->messages ) wp-front-end-login.php:155
  28. Bravo WP security Plugin icon Bravo WP security Plugin10+ installs apply_filters( 'login_messages', $messages ) includes/function.login-header.php:181
  29. CubeAccount Frontend Login icon CubeAccount Frontend Login10+ installs apply_filters( 'login_messages', $messages ) cubeacct_wplogin.php:83
  30. Passwordless icon Passwordless10+ installs apply_filters( 'login_messages', $messages ) login.php:77
  31. Matoma Two-Factor Authentication icon Matoma Two-Factor AuthenticationFewer than 10 installs apply_filters( 'login_messages', $messages ) includes/func.wp-login.php:248
  32. Dashboard Plus icon Dashboard PlusFewer than 10 installs apply_filters( 'login_messages', $messages ) modules/customizer/templates/dashplu-login-page.php:259
  33. Secured WP icon Secured WPFewer than 10 installs apply_filters( 'login_messages', $messages ) classes/Controllers/Modules/Views/class-login-forms.php:760
  34. Multilogin icon MultiloginFewer than 10 installs apply_filters( 'login_messages', $messages ) public/class-logincraft-login-security.php:258
  35. XC Authentication Plugin icon XC Authentication PluginFewer than 10 installs apply_filters( 'login_messages', $messages ) wp-xc-login.php:107

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.