WordPress filter hook · part of WordPress core

auth_cookie_expiration

A WordPress core filter that 61 plugins also fire themselves, running on 5.9M+ sites between them.

“This filter is documented in wp-includes/pluggable.php”

How to use auth_cookie_expiration

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

functions.php
add_filter( 'auth_cookie_expiration', function( $value, $user_id, $remember ) {
	// Change $value here.
	return $value;
}, 10, 3 );

Argument names come from WP Remote Users Sync'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 →

61 plugins that fire auth_cookie_expiration

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

  1. Wordfence Security icon Wordfence Security5+ million installs apply_filters( 'auth_cookie_expiration', $duration, $userID, $remember ) modules/login-security/classes/controller/rest.php:392
  2. Breeze Cache icon Breeze Cache300,000+ installs apply_filters( 'auth_cookie_expiration', 14 * DAY_IN_SECONDS, $current_user->ID, true ) inc/functions.php:355
  3. User Switching icon User Switching200,000+ installs apply_filters( 'auth_cookie_expiration', 172800, get_current_user_id(), false ) user-switching.php:180
  4. InfiniteWP Client icon InfiniteWP Client200,000+ installs apply_filters( 'auth_cookie_expiration', 10800, $current_user->ID, false ) init.php:673
  5. User Profile Builder icon User Profile Builder40,000+ installs apply_filters( 'auth_cookie_expiration', (2 * DAY_IN_SECONDS), $user_id, false ) front-end/edit-profile.php:53
  6. Login as User: See the Site as Any User icon Login as User: See the Site as Any User30,000+ installs apply_filters( 'auth_cookie_expiration', 259200, get_current_user_id(), false ) includes/class-w357-login-as-user.php:218
  7. WPFront User Role Editor icon WPFront User Role Editor30,000+ installs apply_filters( 'auth_cookie_expiration', 172800, get_current_user_id(), false ) includes/users/class-user-switching.php:332
  8. Uncanny Toolkit for LearnDash icon Uncanny Toolkit for LearnDash20,000+ installs apply_filters( 'auth_cookie_expiration', 172800, get_current_user_id(), false ) src/includes/user-switching.php:181
  9. OpenID Connect Generic Client icon OpenID Connect Generic Client10,000+ installs apply_filters( 'auth_cookie_expiration', $wp_expiration_days * DAY_IN_SECONDS, $user->ID, $remember_me ) includes/openid-connect-generic-client-wrapper.php:823
  10. Gmedia Photo Gallery icon Gmedia Photo Gallery7,000+ installs apply_filters( 'auth_cookie_expiration', 1209600, $user->ID, true ) app/inc/json.auth.php:55
  11. AppMySite icon AppMySite7,000+ installs apply_filters( 'auth_cookie_expiration', 14 * DAY_IN_SECONDS, $user->ID, true ) includes/class-ams-rest-routes.php:1114
  12. WP Remote Users Sync icon WP Remote Users Sync5,000+ installs apply_filters( 'auth_cookie_expiration', 14 * DAY_IN_SECONDS, $user_id, $remember ) functions.php:170
  13. AliNext icon AliNext4,000+ installs apply_filters( 'auth_cookie_expiration', $seconds, $user->ID, true ) includes/libs/json_api/controllers/auth.php:86
  14. JSON API User icon JSON API User1,000+ installs apply_filters( 'auth_cookie_expiration', $seconds, $user_id, true ) controllers/User.php:218
  15. Data Exchange for WooCommerce and 1C:Enterprise/1С:Предприятие icon Data Exchange for WooCommerce and 1C:Enterprise/1С:Предприятие1,000+ installs apply_filters( 'auth_cookie_expiration', DAY_IN_SECONDS, $user->ID, false ) exchange.php:215
  16. Subscriptions for WooCommerce Recurring Payments with Membership Content Restriction icon Subscriptions for WooCommerce Recurring Payments with Membership Content Restriction800+ installs apply_filters( 'auth_cookie_expiration', 259200, get_current_user_id(), false ) src/Features/LoginAsUser/Services/Impersonator.php:330
  17. SameSite Cookies icon SameSite Cookies700+ installs apply_filters( 'auth_cookie_expiration', 14 * DAY_IN_SECONDS, $user_id, $remember ) samesite.php:44
  18. Login Me Now icon Login Me Now600+ installs apply_filters( 'auth_cookie_expiration', 172800, get_current_user_id(), false ) app/Logins/UserSwitchingLogin/user-switching.php:151
  19. WP Extended icon WP Extended600+ installs apply_filters( 'auth_cookie_expiration', 172800, get_current_user_id(), false ) modules/user-switching/Module.php:430
  20. JSON API Auth icon JSON API Auth600+ installs apply_filters( 'auth_cookie_expiration', $seconds, $user->ID, true ) controllers/Auth.php:89
  21. Rublon Multi-Factor Authentication (MFA) icon Rublon Multi-Factor Authentication (MFA)400+ installs apply_filters( 'auth_cookie_expiration', (2 * DAY_IN_SECONDS), RublonHelper::getUserId($user), false ) includes/rublon2factor_cookies.php:199
  22. WPO365 icon WPO365200+ installs apply_filters( 'auth_cookie_expiration', 14 * DAY_IN_SECONDS, $user_id, $remember ) wpo365-samesite.php:46
  23. Ultimate Multisite icon Ultimate Multisite100+ installs apply_filters( 'auth_cookie_expiration', 14 * DAY_IN_SECONDS, $user_id, $remember ) inc/sso/auth-functions.php:50
  24. InstaPunchout icon InstaPunchout100+ installs apply_filters( 'auth_cookie_expiration', 2 * DAY_IN_SECONDS, $user_id, false ) instapunchout.php:983
  25. Checkout Gateway for Paddle icon Checkout Gateway for Paddle80+ installs apply_filters( 'auth_cookie_expiration', 14 * \DAY_IN_SECONDS, $user_id, $remember ) includes/User.php:338
  26. WebinarIgnition icon WebinarIgnition70+ installs apply_filters( 'auth_cookie_expiration', 2 * DAY_IN_SECONDS, $user_id, false ) inc/wi-session-keepalive.php:57
  27. AdminEase icon AdminEase50+ installs apply_filters( 'auth_cookie_expiration', 2 * DAY_IN_SECONDS, $target_id, false ) includes/Features/UserSwitch.php:148
  28. BytNexo User Switcher icon BytNexo User Switcher40+ installs apply_filters( 'auth_cookie_expiration', 172800, get_current_user_id(), false ) bytnexo-user-switcher.php:437
  29. CynderHost Cache icon CynderHost Cache40+ installs apply_filters( 'auth_cookie_expiration', 14 * DAY_IN_SECONDS, $user->ID, false ) cynderhost.php:573
  30. TC Ecommerce icon TC Ecommerce30+ installs apply_filters( 'auth_cookie_expiration', $timeinsec, $user_id, true ) controller/app_user.php:146
  31. Infomaniak Connect for OpenID icon Infomaniak Connect for OpenID30+ installs apply_filters( 'auth_cookie_expiration', $wp_expiration_days * DAY_IN_SECONDS, $user->ID, false ) includes/openid-connect-infomaniak-client-wrapper.php:760
  32. appful Mobile App Plugin [OLD icon appful Mobile App Plugin [OLD20+ installs apply_filters( 'auth_cookie_expiration', 1209600, $user->ID, true ) controllers/auth.php:48
  33. Dropshipping with Banggood for WooCommerce (Lite version) icon Dropshipping with Banggood for WooCommerce (Lite version)20+ installs apply_filters( 'auth_cookie_expiration', $seconds, $user->ID, true ) includes/libs/b2wl_json_api/controllers/auth.php:92
  34. vjoon WordPress Adapter icon vjoon WordPress Adapter10+ installs apply_filters( 'auth_cookie_expiration', 14 * DAY_IN_SECONDS, $user_id, $remember ) src/Authorization.php:60
  35. Ultimate View as Customer for Woocommerce icon Ultimate View as Customer for Woocommerce10+ installs apply_filters( 'auth_cookie_expiration', 172800, get_current_user_id(), false ) includes/class-ultimate-view-as-customer-for-woocommerce-user-switching.php:292
  36. 🔐 Access Control icon 🔐 Access Control10+ installs apply_filters( 'auth_cookie_expiration', 172800, get_current_user_id(), false ) includes/plac-access-control.php:263
  37. Mobile App for WooCommerce: ShopApper Mobile App Builder Service for WooCommerce icon Mobile App for WooCommerce: ShopApper Mobile App Builder Service for WooCommerce10+ installs apply_filters( 'auth_cookie_expiration', 14 * DAY_IN_SECONDS, $user->ID, true ) Controllers/AuthController.php:595
  38. Android and iOS App plugin for WooCommerce by WSD icon Android and iOS App plugin for WooCommerce by WSD10+ installs apply_filters( 'auth_cookie_expiration', $seconds, $user->ID, true ) controllers/Auth.php:54
  39. NAPPS icon NAPPS10+ installs apply_filters( 'auth_cookie_expiration', 2 * DAY_IN_SECONDS, $customer, false ) src/Controllers/WooCommerceController.php:263
  40. SSO Cross Cookie icon SSO Cross Cookie10+ installs apply_filters( 'auth_cookie_expiration', 172800 ) sso-cross-cookie-for-multisite.php:79
  41. ProfileSwitch Lite icon ProfileSwitch Lite10+ installs apply_filters( 'auth_cookie_expiration', 2 * DAY_IN_SECONDS, $current_user_id, false ) profileswitch-lite.php:318
  42. Dashboard Quick Lock icon Dashboard Quick Lock10+ installs apply_filters( 'auth_cookie_expiration', 2 * DAY_IN_SECONDS, $this->current_user->ID, false ) includes/class.utility.php:50
  43. Hellō Login icon Hellō Login10+ installs apply_filters( 'auth_cookie_expiration', 2 * DAY_IN_SECONDS, $user->ID, false ) includes/hello-login-client-wrapper.php:538
  44. WPSupervisor Client icon WPSupervisor Client10+ installs apply_filters( 'auth_cookie_expiration', 10800, $current_user->ID, false ) wps-client.php:341
  45. DXP ToolKit icon DXP ToolKit10+ installs apply_filters( 'auth_cookie_expiration', 14 * DAY_IN_SECONDS ) includes/PersonalizationHandler.php:108
  46. PowerSuite Modular Admin Toolkit icon PowerSuite Modular Admin Toolkit10+ installs apply_filters( 'auth_cookie_expiration', 2 * DAY_IN_SECONDS, $user_id, false ) src/OAuth/AuthenticationBridge.php:102
  47. UNIVERSAM icon UNIVERSAM10+ installs apply_filters( 'auth_cookie_expiration', DAY_IN_SECONDS, $user->ID, false ) includes/exchange/1C_api.class.php:155
  48. Rundiz OAuth icon Rundiz OAuth10+ installs apply_filters( 'auth_cookie_expiration', $newLength * DAY_IN_SECONDS, $user_id, $remember ) App/Controllers/Front/HookLoginPage.php:116
  49. Flying Pigs Uploader icon Flying Pigs UploaderFewer than 10 installs apply_filters( 'auth_cookie_expiration', 2 * DAY_IN_SECONDS, $uid, false ) includes/rest-upload.php:1042
  50. PinSwitch User Switcher icon PinSwitch User SwitcherFewer than 10 installs apply_filters( 'auth_cookie_expiration', 172800, get_current_user_id(), false ) includes/class-switching.php:73
  51. Admin Powerups for WooCommerce icon Admin Powerups for WooCommerceFewer than 10 installs apply_filters( 'auth_cookie_expiration', 2 * DAY_IN_SECONDS, get_current_user_id(), false ) src/Modules/SwitchUser/Module.php:520
  52. Icegram User Switching icon Icegram User SwitchingFewer than 10 installs apply_filters( 'auth_cookie_expiration', 172800, get_current_user_id(), false ) switch-user-login-by-icegram.php:165
  53. BoonRisk icon BoonRiskFewer than 10 installs apply_filters( 'auth_cookie_expiration', 2 * DAY_IN_SECONDS, 0, false ) includes/collectors/class-auth-collector.php:185
  54. Beyond Identity Passwordless icon Beyond Identity PasswordlessFewer than 10 installs apply_filters( 'auth_cookie_expiration', 2 * DAY_IN_SECONDS, $user->ID, false ) openid-connect/includes/openid-connect-generic-client-wrapper.php:614
  55. EffortLess Multisite Change Username icon EffortLess Multisite Change UsernameFewer than 10 installs apply_filters( 'auth_cookie_expiration', 2 * DAY_IN_SECONDS, $target, false ) includes/class-elmcu-change-username.php:845
  56. Privacy Portal SSO (for WP) icon Privacy Portal SSO (for WP)Fewer than 10 installs apply_filters( 'auth_cookie_expiration', $wp_expiration_days * DAY_IN_SECONDS, $user->ID, $remember_me ) includes/pp-sso-client-wrapper.php:885
  57. NeonaFM Commerce icon NeonaFM CommerceFewer than 10 installs apply_filters( 'auth_cookie_expiration', 14 * DAY_IN_SECONDS, $uid, true ) includes/class-neonco-account.php:142
  58. Nonce Failure Explainer icon Nonce Failure ExplainerFewer than 10 installs apply_filters( 'auth_cookie_expiration', 2 * DAY_IN_SECONDS, 0, false ) includes/class-noncfaex-environment.php:74
  59. PaintClarity icon PaintClarityFewer than 10 installs apply_filters( 'auth_cookie_expiration', 14 * DAY_IN_SECONDS, $uid, true ) paintops.php:2311
  60. Watrix Login as User icon Watrix Login as UserFewer than 10 installs apply_filters( 'auth_cookie_expiration', 2 * DAY_IN_SECONDS, $target_id, false ) includes/class-switcher.php:299
  61. wpmanagerpro icon wpmanagerproFewer than 10 installs apply_filters( 'auth_cookie_expiration', 10800, $current_user->ID, false ) class/core.php:351

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.