WordPress action hook · part of WordPress core

updated_option

A WordPress core action that 29 plugins also fire themselves, running on 55K+ sites between them.

How to use updated_option

It's an action: your callback runs at that point and receives 3 arguments. Nothing needs to be returned. Add this to your theme's functions.php or a small custom plugin:

functions.php
add_action( 'updated_option', function( $option, $old_value, $value ) {
	// Your code runs here.
}, 10, 3 );

Argument names come from Animation Addons for Elementor'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 →

29 plugins that fire updated_option

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

  1. BeyondSEO icon BeyondSEO20,000+ installs do_action( 'updated_option', BaseConstants::OPTION_PLUGIN_SETTINGS, $expected['value'], $value ) inc/Core/Storage/SettingsStorage.php:144
  2. Animation Addons for Elementor icon Animation Addons for Elementor10,000+ installs do_action( 'updated_option', $option, $old_value, $value ) inc/Compat/Key_Bridge.php:449
  3. Variation Swatches for WooCommerce icon Variation Swatches for WooCommerce9,000+ installs do_action( 'updated_option', 'rtwpvs', $old_value, $value ) app/Controllers/Install.php:648
  4. Five Star Business Profile and Schema icon Five Star Business Profile and Schema7,000+ installs do_action( 'updated_option', $option, $old, $value ) includes/class-settings-mutation.php:286
  5. MLSImport: IDX Plugin & MLS Plugin for Real Estate Listings icon MLSImport: IDX Plugin & MLS Plugin for Real Estate Listings4,000+ installs do_action( 'updated_option', $option_name, $expected, $replacement ) includes/mlsimport-progressive-save.php:157
  6. SOOZ icon SOOZ2,000+ installs do_action( 'updated_option', $option_name, $expected_snapshot['value'], $new_option_value ) includes/core/wordpress-options.php:608
  7. Listdom: AI-powered Business Directory with Classifieds Ads Listings icon Listdom: AI-powered Business Directory with Classifieds Ads Listings1,000+ installs do_action( 'updated_option', $option, $old, $value ) app/includes/options.php:124
  8. BetterShield icon BetterShield1,000+ installs do_action( 'updated_option', $name, $old, $value ) src/Remediation/Observed.php:223
  9. Exchange Rates icon Exchange Rates800+ installs do_action( 'updated_option', $option, $old_value, $value ) src/Service/UpdateDataSources.php:204
  10. GT Link Manager icon GT Link Manager100+ installs do_action( 'updated_option', 'gtlm_settings', $old, $next ) includes/class-gt-link-db.php:491
  11. VERIFIED Crypto Checkout icon VERIFIED Crypto Checkout100+ installs do_action( 'updated_option', $entry['option_name'], $old, $new ) includes/wallet-setup/class-vccp-wallet-store.php:90
  12. WebinarIgnition icon WebinarIgnition80+ installs do_action( 'updated_option', $name, $old, $data ) inc/wi-agent-launch-kit.php:413
  13. Webcam/Screen/Mic Recorder for Video Comments and Forms icon Webcam/Screen/Mic Recorder for Video Comments and Forms50+ installs do_action( 'updated_option', self::OPTION, $row['value'], $updated ) inc/class-creator-onboarding.php:80
  14. Webcam Microphone Screen Recorder icon Webcam Microphone Screen Recorder30+ installs do_action( 'updated_option', self::OPTION, $row['value'], $updated ) inc/class-creator-onboarding.php:80
  15. Maestro: The Inline Admin Menu Editor icon Maestro: The Inline Admin Menu Editor30+ installs do_action( 'updated_option', MAESTRO_OPTION, $stored, $clean ) includes/class-config.php:423
  16. CYBERMAPS: XML Sitemaps & llms.txt icon CYBERMAPS: XML Sitemaps & llms.txt20+ installs do_action( 'updated_option', $option, $before['value'], $after['value'] ) src/Admin/ConfigurationMutationStore.php:75
  17. UltraCache icon UltraCache20+ installs do_action( 'updated_option', $option_name, $old_value, $new_value ) includes/media/replacement/class-media-replacement-database-trait.php:412
  18. Aculect Icon Library icon Aculect Icon Library10+ installs do_action( 'updated_option', $name, $values[0], $values[1] ) src/OptionMutationLock.php:288
  19. Aculect AI Companion icon Aculect AI Companion10+ installs do_action( 'updated_option', self::OPTION, $old_value, $new_value ) src/Intelligence/LearningSuggestionQueueStorage.php:153
  20. VN Speed Optimizer icon VN Speed Optimizer10+ installs do_action( 'updated_option', 'vnspo_options', $before, $after ) src/Services/AI/ReviewQueue.php:559
  21. CustomFields.com icon CustomFields.comFewer than 10 installs do_action( 'updated_option', $name, $before, $groups ) includes/class-admin.php:187
  22. PerfLocale icon PerfLocaleFewer than 10 installs do_action( 'updated_option', $option, $old_value, $value ) src/Database/OptionWriter.php:278
  23. JonnyAD SEO icon JonnyAD SEOFewer than 10 installs do_action( 'updated_option', $name, $old, $value ) includes/assist.php:300
  24. Lumioh SEO icon Lumioh SEOFewer than 10 installs do_action( 'updated_option', $key, $current['value'], $value ) includes/class-lumioh-seo-revisions.php:564
  25. TamRank SEO icon TamRank SEOFewer than 10 installs do_action( 'updated_option', $name, $change['old'], $change['new'] ) includes/class-tamrank-manual-task-source.php:72
  26. CatalogFAQ icon CatalogFAQFewer than 10 installs do_action( 'updated_option', $key, $expected, $next ) src/Core.php:385
  27. Cliredas icon CliredasFewer than 10 installs do_action( 'updated_option', $key, $old, $replacement ) includes/class-cliredas-local-store.php:52
  28. Fortop Referral Search Term icon Fortop Referral Search TermFewer than 10 installs do_action( 'updated_option', $name, $expected, $next ) includes/class-stt2m-option-cas.php:53
  29. Klusio icon KlusioFewer than 10 installs do_action( 'updated_option', $key, $oud, $nieuw ) klusio-builder-bridge.php:2472

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.