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:
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.
-
BeyondSEO20,000+ installs
do_action( 'updated_option', BaseConstants::OPTION_PLUGIN_SETTINGS, $expected['value'], $value )inc/Core/Storage/SettingsStorage.php:144 -
Animation Addons for Elementor10,000+ installs
do_action( 'updated_option', $option, $old_value, $value )inc/Compat/Key_Bridge.php:449 -
Variation Swatches for WooCommerce9,000+ installs
do_action( 'updated_option', 'rtwpvs', $old_value, $value )app/Controllers/Install.php:648 -
Five Star Business Profile and Schema7,000+ installs
do_action( 'updated_option', $option, $old, $value )includes/class-settings-mutation.php:286 -
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 -
SOOZ2,000+ installs
do_action( 'updated_option', $option_name, $expected_snapshot['value'], $new_option_value )includes/core/wordpress-options.php:608 -
Listdom: AI-powered Business Directory with Classifieds Ads Listings1,000+ installs
do_action( 'updated_option', $option, $old, $value )app/includes/options.php:124 -
BetterShield1,000+ installs
do_action( 'updated_option', $name, $old, $value )src/Remediation/Observed.php:223 -
Exchange Rates800+ installs
do_action( 'updated_option', $option, $old_value, $value )src/Service/UpdateDataSources.php:204 -
GT Link Manager100+ installs
do_action( 'updated_option', 'gtlm_settings', $old, $next )includes/class-gt-link-db.php:491 -
VERIFIED Crypto Checkout100+ installs
do_action( 'updated_option', $entry['option_name'], $old, $new )includes/wallet-setup/class-vccp-wallet-store.php:90 -
WebinarIgnition80+ installs
do_action( 'updated_option', $name, $old, $data )inc/wi-agent-launch-kit.php:413 -
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 -
Webcam Microphone Screen Recorder30+ installs
do_action( 'updated_option', self::OPTION, $row['value'], $updated )inc/class-creator-onboarding.php:80 -
Maestro: The Inline Admin Menu Editor30+ installs
do_action( 'updated_option', MAESTRO_OPTION, $stored, $clean )includes/class-config.php:423 -
CYBERMAPS: XML Sitemaps & llms.txt20+ installs
do_action( 'updated_option', $option, $before['value'], $after['value'] )src/Admin/ConfigurationMutationStore.php:75 -
UltraCache20+ installs
do_action( 'updated_option', $option_name, $old_value, $new_value )includes/media/replacement/class-media-replacement-database-trait.php:412 -
Aculect Icon Library10+ installs
do_action( 'updated_option', $name, $values[0], $values[1] )src/OptionMutationLock.php:288 -
Aculect AI Companion10+ installs
do_action( 'updated_option', self::OPTION, $old_value, $new_value )src/Intelligence/LearningSuggestionQueueStorage.php:153 -
VN Speed Optimizer10+ installs
do_action( 'updated_option', 'vnspo_options', $before, $after )src/Services/AI/ReviewQueue.php:559 -
CustomFields.comFewer than 10 installs
do_action( 'updated_option', $name, $before, $groups )includes/class-admin.php:187 -
PerfLocaleFewer than 10 installs
do_action( 'updated_option', $option, $old_value, $value )src/Database/OptionWriter.php:278 -
JonnyAD SEOFewer than 10 installs
do_action( 'updated_option', $name, $old, $value )includes/assist.php:300 -
Lumioh SEOFewer than 10 installs
do_action( 'updated_option', $key, $current['value'], $value )includes/class-lumioh-seo-revisions.php:564 -
TamRank SEOFewer than 10 installs
do_action( 'updated_option', $name, $change['old'], $change['new'] )includes/class-tamrank-manual-task-source.php:72 -
CatalogFAQFewer than 10 installs
do_action( 'updated_option', $key, $expected, $next )src/Core.php:385 -
CliredasFewer than 10 installs
do_action( 'updated_option', $key, $old, $replacement )includes/class-cliredas-local-store.php:52 -
Fortop Referral Search TermFewer than 10 installs
do_action( 'updated_option', $name, $expected, $next )includes/class-stt2m-option-cas.php:53 -
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.