WordPress filter hook · part of WordPress core
upgrader_source_selection
A WordPress core filter that 37 plugins also fire themselves, running on 9.6M+ sites between them.
“Filter the source file location for the upgrade package.”
How to use upgrader_source_selection
It's a filter: your callback receives the value and 3 more arguments, and must return the (changed) value.
Add this to your theme's functions.php or a small custom plugin:
add_filter( 'upgrader_source_selection', function( $source, $remote_source, $object, $args ) {
// Change $source here.
return $source;
}, 10, 4 );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 →
37 plugins that fire upgrader_source_selection
Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.
-
WPForms5+ million installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )src/Helpers/PluginSilentUpgrader.php:483 -
MonsterInsights2+ million installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/admin/licensing/plugin-upgrader-legacy.php:480 -
Smash Balloon Social Photo Feed1+ million installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )inc/admin/PluginSilentUpgrader.php:442 -
WP Mail Logging300,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )src/inc/Helpers/PluginSilentUpgrader.php:469 -
ExactMetrics200,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/admin/licensing/plugin-upgrader-legacy.php:480 -
UserFeedback200,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/admin/licensing/plugin-upgrader.php:467 -
Smash Balloon Social Post Feed100,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )inc/Helpers/PluginSilentUpgrader.php:477 -
Custom Twitter Feeds100,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )inc/Admin/PluginSilentUpgrader.php:470 -
Feeds for YouTube (YouTube video, channel, and gallery plugin)100,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )inc/PluginSilentUpgrader.php:470 -
ProfilePress100,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )src/Classes/Installer/PluginSilentUpgrader.php:472 -
Reviews Feed100,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )class/Common/Helpers/PluginSilentUpgrader.php:479 -
LoginWP (Formerly Peter’s Login Redirect)80,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )src/core/src/Admin/Installer/PluginSilentUpgrader.php:472 -
kk Star Ratings70,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )lib/Installer/KKStar_PluginSilentUpgrader.php:466 -
Feeds for TikTok (TikTok feed, video, and gallery plugin)70,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )inc/Common/Helpers/PluginSilentUpgrader.php:484 -
Easy Digital Downloads40,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )src/Admin/Installers/PluginSilentUpgrader.php:473 -
Popup Box40,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/admin/class-ays-pb-upgrader.php:469 -
Secure Copy Content Protection and Content Locking20,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/admin/class-secure-copy-content-protection-upgrader.php:469 -
Uncanny Toolkit for LearnDash20,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )src/uncanny-one-click-installer/includes/PluginSilentUpgrader.php:463 -
Quiz Maker by AYS20,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/admin/class-quiz-maker-upgrader.php:469 -
Change Mail Sender20,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )src/Helpers/PluginSilentUpgrader.php:464 -
FunnelKit Automations20,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/plugin_helpers/class-bwfan-plugin-silent-upgrader.php:467 -
MailOptin10,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )src/core/src/Admin/Installer/PluginSilentUpgrader.php:472 -
PushEngage8,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )app/Utils/PluginUpgraderSilent.php:485 -
Registrations for the Events Calendar7,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/helpers/PluginSilentUpgrader.php:472 -
Poll Maker by AYS6,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/admin/class-poll-maker-upgrader.php:469 -
Chartify3,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/admin/class-chart-builder-upgrader.php:469 -
Admin Bar & Dashboard Access Control3,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )fuse/Installer/PluginSilentUpgrader.php:466 -
Photo Gallery by Ays1,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/admin/class-gallery-photo-gallery-upgrader.php:469 -
Pie Register1,000+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )classes/admin/PieRegPluginSilentUpgrader.php:452 -
AI ChatBot with ChatGPT and Content Generator by AYS300+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/admin/class-chatgpt-assistant-upgrader.php:469 -
Advanced Related Posts300+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/admin/class-advanced-related-posts-upgrader.php:469 -
Easy Form100+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/admin/class-ays-form-maker-upgrader.php:475 -
RewardsWP100+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )src/Pluggable/PluginSilentUpgrader.php:481 -
FAQ Builder AYS100+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/admin/class-faq-builder-upgrader.php:469 -
Pie Forms80+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/core/helper/plugin-silent-upgrader.php:448 -
Personal Dictionary70+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/admin/class-personal-dictionary-upgrader.php:469 -
Fox LMS60+ installs
apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] )includes/admin/class-fox-lms-upgrader.php:469
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.