WordPress filter hook · part of WordPress core

upgrader_post_install

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

“Filter the installation response after the installation has finished.”

How to use upgrader_post_install

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( 'upgrader_post_install', function( $value, $args, $result ) {
	// Change $value here.
	return $value;
}, 10, 3 );

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_post_install

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_post_install', true, $args['hook_extra'], $this->result ) src/Helpers/PluginSilentUpgrader.php:583
  2. MonsterInsights icon MonsterInsights2+ million installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/admin/licensing/plugin-upgrader-legacy.php:580
  3. Smash Balloon Social Photo Feed icon Smash Balloon Social Photo Feed1+ million installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) inc/admin/PluginSilentUpgrader.php:536
  4. WP Mail Logging icon WP Mail Logging300,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) src/inc/Helpers/PluginSilentUpgrader.php:569
  5. ExactMetrics icon ExactMetrics200,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/admin/licensing/plugin-upgrader-legacy.php:580
  6. UserFeedback icon UserFeedback200,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/admin/licensing/plugin-upgrader.php:563
  7. Smash Balloon Social Post Feed icon Smash Balloon Social Post Feed100,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) inc/Helpers/PluginSilentUpgrader.php:573
  8. Custom Twitter Feeds icon Custom Twitter Feeds100,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) inc/Admin/PluginSilentUpgrader.php:566
  9. 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_post_install', true, $args['hook_extra'], $this->result ) inc/PluginSilentUpgrader.php:566
  10. ProfilePress icon ProfilePress100,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) src/Classes/Installer/PluginSilentUpgrader.php:564
  11. Reviews Feed icon Reviews Feed100,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) class/Common/Helpers/PluginSilentUpgrader.php:575
  12. LoginWP (Formerly Peter’s Login Redirect) icon LoginWP (Formerly Peter’s Login Redirect)80,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) src/core/src/Admin/Installer/PluginSilentUpgrader.php:564
  13. kk Star Ratings icon kk Star Ratings70,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) lib/Installer/KKStar_PluginSilentUpgrader.php:558
  14. 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_post_install', true, $args['hook_extra'], $this->result ) inc/Common/Helpers/PluginSilentUpgrader.php:580
  15. Easy Digital Downloads icon Easy Digital Downloads40,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) src/Admin/Installers/PluginSilentUpgrader.php:573
  16. Popup Box icon Popup Box40,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/admin/class-ays-pb-upgrader.php:569
  17. Secure Copy Content Protection and Content Locking icon Secure Copy Content Protection and Content Locking20,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/admin/class-secure-copy-content-protection-upgrader.php:569
  18. Uncanny Toolkit for LearnDash icon Uncanny Toolkit for LearnDash20,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) src/uncanny-one-click-installer/includes/PluginSilentUpgrader.php:563
  19. Quiz Maker by AYS icon Quiz Maker by AYS20,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/admin/class-quiz-maker-upgrader.php:569
  20. Change Mail Sender icon Change Mail Sender20,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) src/Helpers/PluginSilentUpgrader.php:564
  21. FunnelKit Automations icon FunnelKit Automations20,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/plugin_helpers/class-bwfan-plugin-silent-upgrader.php:569
  22. MailOptin icon MailOptin10,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) src/core/src/Admin/Installer/PluginSilentUpgrader.php:564
  23. PushEngage icon PushEngage8,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) app/Utils/PluginUpgraderSilent.php:567
  24. Registrations for the Events Calendar icon Registrations for the Events Calendar7,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/helpers/PluginSilentUpgrader.php:568
  25. Poll Maker by AYS icon Poll Maker by AYS6,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/admin/class-poll-maker-upgrader.php:569
  26. Chartify icon Chartify3,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/admin/class-chart-builder-upgrader.php:569
  27. Admin Bar & Dashboard Access Control icon Admin Bar & Dashboard Access Control3,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) fuse/Installer/PluginSilentUpgrader.php:558
  28. Photo Gallery by Ays icon Photo Gallery by Ays1,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/admin/class-gallery-photo-gallery-upgrader.php:569
  29. Pie Register icon Pie Register1,000+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) classes/admin/PieRegPluginSilentUpgrader.php:546
  30. AI ChatBot with ChatGPT and Content Generator by AYS icon AI ChatBot with ChatGPT and Content Generator by AYS300+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/admin/class-chatgpt-assistant-upgrader.php:569
  31. Advanced Related Posts icon Advanced Related Posts300+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/admin/class-advanced-related-posts-upgrader.php:569
  32. Easy Form icon Easy Form100+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/admin/class-ays-form-maker-upgrader.php:575
  33. RewardsWP icon RewardsWP100+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) src/Pluggable/PluginSilentUpgrader.php:583
  34. FAQ Builder AYS icon FAQ Builder AYS100+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/admin/class-faq-builder-upgrader.php:569
  35. Pie Forms icon Pie Forms80+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/core/helper/plugin-silent-upgrader.php:540
  36. Personal Dictionary icon Personal Dictionary70+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/admin/class-personal-dictionary-upgrader.php:569
  37. Fox LMS icon Fox LMS60+ installs apply_filters( 'upgrader_post_install', true, $args['hook_extra'], $this->result ) includes/admin/class-fox-lms-upgrader.php:569

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.