WordPress filter hook

login_body_class

Fired by 31 WordPress plugins, running on 4.9M+ sites between them.

“Filters the login page body classes.”

How to use login_body_class

It's a filter: your callback receives the value and 1 more argument, and must return the (changed) value. Add this to your theme's functions.php or a small custom plugin:

functions.php
add_filter( 'login_body_class', function( $classes, $action ) {
	// Change $classes here.
	return $classes;
}, 10, 2 );

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.

31 plugins that fire login_body_class

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_body_class', $classes, $action ) security/wordpress/two-fa/function-login-header.php:175
  2. Kadence Security icon Kadence Security700,000+ installs apply_filters( 'login_body_class', $classes, $action ) core/lib/includes/function.login-header.php:129
  3. Nextend Social Login and Register icon Nextend Social Login and Register200,000+ installs apply_filters( 'login_body_class', $classes, $action ) includes/compat-wp-login.php:206
  4. LoginPress icon LoginPress200,000+ installs apply_filters( 'login_body_class', $classes, $action ) include/template-loginpress.php:147
  5. Two Factor icon Two Factor100,000+ installs apply_filters( 'login_body_class', $classes, $action ) includes/function.login-header.php:178
  6. WP 2FA icon WP 2FA100,000+ installs apply_filters( 'login_body_class', $classes, $action ) includes/functions/login-header.php:141
  7. Hide My WP Ghost icon Hide My WP Ghost100,000+ installs apply_filters( 'login_body_class', $classes, $action ) view/wplogin/header.php:247
  8. Defender Security icon Defender Security80,000+ installs apply_filters( 'login_body_class', $classes, $action ) src/view/two-fa/otp.php:167
  9. Custom Login Page Customizer icon Custom Login Page Customizer80,000+ installs apply_filters( 'login_body_class', $classes, $action ) src/Customizer/template-login-customizer.php:78
  10. All In One Login icon All In One Login60,000+ installs apply_filters( 'login_body_class', array( 'login', 'login-action-login', 'wp-core-ui' ) ) includes/two-factor/settings/two-factor-auth.php:43
  11. Titan Anti-spam & Security icon Titan Anti-spam & Security50,000+ installs apply_filters( 'login_body_class', $classes, $action ) includes/tweaks/password-requirements/login-interstitial/functions-login-header.php:150
  12. WP Hide & Security Enhancer icon WP Hide & Security Enhancer50,000+ installs apply_filters( 'login_body_class', $classes, $action ) modules/components/login_2fa_template_login_header.php:177
  13. Ultimate Dashboard icon Ultimate Dashboard50,000+ installs apply_filters( 'login_body_class', $classes, $action ) modules/login-customizer/templates/udb-login-page.php:149
  14. Custom Login Page Customizer icon Custom Login Page Customizer50,000+ installs apply_filters( 'login_body_class', $clc_classes, 'login' ) includes/login-template.php:161
  15. Divi Torque Lite icon Divi Torque Lite50,000+ installs apply_filters( 'login_body_class', $classes, $action ) includes/deprecated/extensions/login-designer/ext-template-login-designer.php:73
  16. SecuPress with Simple SSL icon SecuPress with Simple SSL40,000+ installs apply_filters( 'login_body_class', $classes, $sp_action ) free/functions/formatting.php:244
  17. Shield Security icon Shield Security30,000+ installs apply_filters( 'login_body_class', $classes, $action ) src/ActionRouter/Actions/Render/FullPage/Mfa/Components/WpLoginReplicaHeader.php:115
  18. Loginfy icon Loginfy2,000+ installs apply_filters( 'login_body_class', $classes, $action ) Inc/Core/Inc/loginfy-login-template.php:187
  19. School Management System icon School Management System1,000+ installs apply_filters( 'login_body_class', $classes, $action ) wpsp-school-login.php:128
  20. Login Page Customizer icon Login Page Customizer1,000+ installs apply_filters( 'login_body_class', $classes, $action ) login-page-customizer/customize/template-lpc-custom-login-page.php:126
  21. CLP icon CLP600+ installs apply_filters( 'login_body_class', $classes, $action ) includes/customizer-login-template.php:94
  22. Admin Optimizer icon Admin Optimizer100+ installs apply_filters( 'login_body_class', $classes, $action ) modules/2fa/includes/wp-2fa-login.php:182
  23. Login Page UI Customizer icon Login Page UI Customizer100+ installs apply_filters( 'login_body_class', $classes, 'login' ) includes/login-page-template.php:131
  24. Fuerte-WP icon Fuerte-WP70+ installs apply_filters( 'login_body_class', $classes, $action ) includes/two-factor/includes/function.login-header.php:179
  25. Loginify icon Loginify20+ installs apply_filters( 'login_body_class', $classes, $action ) templates/loginify-page.php:55
  26. WP Front End Login icon WP Front End Login10+ installs apply_filters( 'login_body_class', $classes, $action ) wp-front-end-login.php:957
  27. Bravo WP security Plugin icon Bravo WP security Plugin10+ installs apply_filters( 'login_body_class', $classes, $action ) includes/function.login-header.php:123
  28. CryptoPhoto icon CryptoPhoto10+ installs apply_filters( 'login_body_class', $classes, $action ) cryptophoto.php:84
  29. Matoma Two-Factor Authentication icon Matoma Two-Factor AuthenticationFewer than 10 installs apply_filters( 'login_body_class', $classes, $action ) includes/func.wp-login.php:175
  30. Dashboard Plus icon Dashboard PlusFewer than 10 installs apply_filters( 'login_body_class', $classes, $action ) modules/customizer/templates/dashplu-login-page.php:182
  31. Secured WP icon Secured WPFewer than 10 installs apply_filters( 'login_body_class', $classes, $action ) classes/Controllers/Modules/Views/class-login-forms.php:687

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.