WordPress filter hook · part of WordPress core

upgrader_package_options

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

“Filter the package options before running an update.”

How to use upgrader_package_options

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

Argument names come from WPForms'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 →

39 plugins that fire upgrader_package_options

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

  1. WPForms icon WPForms5+ million installs apply_filters( 'upgrader_package_options', $options ) src/Helpers/PluginSilentUpgrader.php:107
  2. MonsterInsights icon MonsterInsights2+ million installs apply_filters( 'upgrader_package_options', $options ) includes/admin/licensing/plugin-upgrader-legacy.php:102
  3. Smash Balloon Social Photo Feed icon Smash Balloon Social Photo Feed1+ million installs apply_filters( 'upgrader_package_options', $options ) inc/admin/PluginSilentUpgrader.php:104
  4. WP Mail Logging icon WP Mail Logging300,000+ installs apply_filters( 'upgrader_package_options', $options ) src/inc/Helpers/PluginSilentUpgrader.php:103
  5. ExactMetrics icon ExactMetrics200,000+ installs apply_filters( 'upgrader_package_options', $options ) includes/admin/licensing/plugin-upgrader-legacy.php:102
  6. UserFeedback icon UserFeedback200,000+ installs apply_filters( 'upgrader_package_options', $options ) includes/admin/licensing/plugin-upgrader.php:98
  7. Anti-Spam, Spam FireWall by CleanTalk icon Anti-Spam, Spam FireWall by CleanTalk200,000+ installs apply_filters( 'upgrader_package_options', $options ) lib/Cleantalk/ApbctWP/CleantalkUpgrader.php:104
  8. Smash Balloon Social Post Feed icon Smash Balloon Social Post Feed100,000+ installs apply_filters( 'upgrader_package_options', $options ) inc/Helpers/PluginSilentUpgrader.php:107
  9. Custom Twitter Feeds icon Custom Twitter Feeds100,000+ installs apply_filters( 'upgrader_package_options', $options ) inc/Admin/PluginSilentUpgrader.php:103
  10. Feeds for YouTube (YouTube video, channel, and gallery plugin) icon Feeds for YouTube (YouTube video, channel, and gallery plugin)100,000+ installs apply_filters( 'upgrader_package_options', $options ) inc/PluginSilentUpgrader.php:103
  11. ProfilePress icon ProfilePress100,000+ installs apply_filters( 'upgrader_package_options', $options ) src/Classes/Installer/PluginSilentUpgrader.php:99
  12. Reviews Feed icon Reviews Feed100,000+ installs apply_filters( 'upgrader_package_options', $options ) class/Common/Helpers/PluginSilentUpgrader.php:107
  13. LoginWP (Formerly Peter’s Login Redirect) icon LoginWP (Formerly Peter’s Login Redirect)80,000+ installs apply_filters( 'upgrader_package_options', $options ) src/core/src/Admin/Installer/PluginSilentUpgrader.php:99
  14. kk Star Ratings icon kk Star Ratings70,000+ installs apply_filters( 'upgrader_package_options', $options ) lib/Installer/KKStar_PluginSilentUpgrader.php:93
  15. Feeds for TikTok (TikTok feed, video, and gallery plugin) icon Feeds for TikTok (TikTok feed, video, and gallery plugin)70,000+ installs apply_filters( 'upgrader_package_options', $options ) inc/Common/Helpers/PluginSilentUpgrader.php:114
  16. Easy Digital Downloads icon Easy Digital Downloads40,000+ installs apply_filters( 'upgrader_package_options', $options ) src/Admin/Installers/PluginSilentUpgrader.php:103
  17. Popup Box icon Popup Box40,000+ installs apply_filters( 'upgrader_package_options', $options ) includes/admin/class-ays-pb-upgrader.php:94
  18. Security Plugin, Firewall & Malware Scanner with Auto Removal icon Security Plugin, Firewall & Malware Scanner with Auto Removal40,000+ installs apply_filters( 'upgrader_package_options', $options ) lib/CleantalkSP/SpbctWP/Upgrader.php:105
  19. Secure Copy Content Protection and Content Locking icon Secure Copy Content Protection and Content Locking20,000+ installs apply_filters( 'upgrader_package_options', $options ) includes/admin/class-secure-copy-content-protection-upgrader.php:94
  20. Uncanny Toolkit for LearnDash icon Uncanny Toolkit for LearnDash20,000+ installs apply_filters( 'upgrader_package_options', $options ) src/uncanny-one-click-installer/includes/PluginSilentUpgrader.php:112
  21. Quiz Maker by AYS icon Quiz Maker by AYS20,000+ installs apply_filters( 'upgrader_package_options', $options ) includes/admin/class-quiz-maker-upgrader.php:94
  22. Change Mail Sender icon Change Mail Sender20,000+ installs apply_filters( 'upgrader_package_options', $options ) src/Helpers/PluginSilentUpgrader.php:103
  23. FunnelKit Automations icon FunnelKit Automations20,000+ installs apply_filters( 'upgrader_package_options', $options ) includes/plugin_helpers/class-bwfan-plugin-silent-upgrader.php:94
  24. MailOptin icon MailOptin10,000+ installs apply_filters( 'upgrader_package_options', $options ) src/core/src/Admin/Installer/PluginSilentUpgrader.php:99
  25. PushEngage icon PushEngage8,000+ installs apply_filters( 'upgrader_package_options', $options ) app/Utils/PluginUpgraderSilent.php:98
  26. Registrations for the Events Calendar icon Registrations for the Events Calendar7,000+ installs apply_filters( 'upgrader_package_options', $options ) includes/helpers/PluginSilentUpgrader.php:103
  27. Poll Maker by AYS icon Poll Maker by AYS6,000+ installs apply_filters( 'upgrader_package_options', $options ) includes/admin/class-poll-maker-upgrader.php:94
  28. Chartify icon Chartify3,000+ installs apply_filters( 'upgrader_package_options', $options ) includes/admin/class-chart-builder-upgrader.php:94
  29. Admin Bar & Dashboard Access Control icon Admin Bar & Dashboard Access Control3,000+ installs apply_filters( 'upgrader_package_options', $options ) fuse/Installer/PluginSilentUpgrader.php:93
  30. Photo Gallery by Ays icon Photo Gallery by Ays1,000+ installs apply_filters( 'upgrader_package_options', $options ) includes/admin/class-gallery-photo-gallery-upgrader.php:94
  31. Pie Register icon Pie Register1,000+ installs apply_filters( 'upgrader_package_options', $options ) classes/admin/PieRegPluginSilentUpgrader.php:94
  32. AI ChatBot with ChatGPT and Content Generator by AYS icon AI ChatBot with ChatGPT and Content Generator by AYS300+ installs apply_filters( 'upgrader_package_options', $options ) includes/admin/class-chatgpt-assistant-upgrader.php:94
  33. Advanced Related Posts icon Advanced Related Posts300+ installs apply_filters( 'upgrader_package_options', $options ) includes/admin/class-advanced-related-posts-upgrader.php:94
  34. Easy Form icon Easy Form100+ installs apply_filters( 'upgrader_package_options', $options ) includes/admin/class-ays-form-maker-upgrader.php:94
  35. RewardsWP icon RewardsWP100+ installs apply_filters( 'upgrader_package_options', $options ) src/Pluggable/PluginSilentUpgrader.php:116
  36. FAQ Builder AYS icon FAQ Builder AYS100+ installs apply_filters( 'upgrader_package_options', $options ) includes/admin/class-faq-builder-upgrader.php:94
  37. Pie Forms icon Pie Forms80+ installs apply_filters( 'upgrader_package_options', $options ) includes/core/helper/plugin-silent-upgrader.php:97
  38. Personal Dictionary icon Personal Dictionary70+ installs apply_filters( 'upgrader_package_options', $options ) includes/admin/class-personal-dictionary-upgrader.php:94
  39. Fox LMS icon Fox LMS60+ installs apply_filters( 'upgrader_package_options', $options ) includes/admin/class-fox-lms-upgrader.php:94

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.