WordPress hook directory
option_{$setting}

Important warning about variable hooks

Some hooks have variables in their names. For example, pre_${taxonomy}_$field and admin_head- both have variable names. In general, any hook that ends (or begins) with - or _, or contains a $, has a variable name. Since the syntax with which these variables are defined may change from version to version, this page may think that a hook is deprecated (or new) even if it is not. You can usually catch this sort of thing by comparing this hook to the list of "related hooks" below.

WordPress version history for option_{$setting}

This database has information for all major versions from WP 1.2.1 through 6.2.

Version	File	Line		Type
1.5.2	wp-includes/functions.php	244	View in context	filter
1.5.2	wp-includes/functions.php	247	View in context	filter
1.5.2	wp-includes/functions.php	262	View in context	filter
1.5.2	wp-includes/functions.php	263	View in context	filter
2.0	wp-includes/functions.php	300	View in context	filter
2.0.11	wp-includes/functions.php	330	View in context	filter
2.1	wp-includes/functions.php	230	View in context	filter
2.2	wp-includes/functions.php	251	View in context	filter
2.3	wp-includes/functions.php	224	View in context	filter
2.5	wp-includes/functions.php	243	View in context	filter
2.6	wp-includes/functions.php	368	View in context	filter
2.7	wp-includes/functions.php	388	View in context	filter
2.8	wp-includes/functions.php	367	View in context	filter
2.9	wp-includes/functions.php	367	View in context	filter

Important warning!

This hook does not occur in the most recent version of WordPress (6.2). Do not use it. It is deprecated. You should look at the list of "related hooks" below to see if you can figure out what replaced it.

Related Hooks

We find related hooks using word stems. option_{$setting} has 2 significant word stem(s): option, setting. Note that some of the hooks below may not appear in all versions of WP.

• Hooks with 2 identical stems
  • blog_option_{$setting}
  • pre_option_{$setting}
• Hooks with 1 identical stem
  • add_option
  • add_option_{$name}
  • add_option_{$option}
  • add_site_option
  • add_site_option_{$key}
  • add_site_option_{$option}
  • added_option
  • blog_option_{$option}
  • customize_dynamic_setting_args
  • customize_dynamic_setting_class
  • customize_post_value_set_{$setting_id}
  • customize_validate_{$setting->id}
  • default_option_{$option}
  • default_site_option_{$option}
  • delete_option
  • delete_option_{$option}
  • delete_site_option
  • delete_site_option_{$key}
  • delete_site_option_{$option}
  • deleted_option
  • get_user_option_{$option}
  • option_enable_xmlrpc
  • option_page_capability_{$option_page}
  • option_{$option_name}
  • option_{$option}
  • plugin_auto_update_setting_html
  • pre_add_site_option_{$key}
  • pre_add_site_option_{$option}
  • pre_delete_site_option_{$option}
  • pre_option
  • pre_option_enable_xmlrpc
  • pre_option_{$option->option_name}
  • pre_option_{$option}
  • pre_site_option_{$key}
  • pre_site_option_{$option}
  • pre_update_option
  • pre_update_option_{$option_name}
  • pre_update_option_{$option}
  • pre_update_site_option_{$key}
  • pre_update_site_option_{$option}
  • register_setting
  • register_setting_args
  • rest_pre_get_setting
  • rest_pre_update_setting
  • sanitize_option_{$option}
  • set-screen-option
  • set_screen_option_{$option}
  • site_option_{$key}
  • site_option_{$option}
  • theme_auto_update_setting_html
  • theme_auto_update_setting_template
  • unregister_setting
  • update_option
  • update_option_{$option_name}
  • update_option_{$option}
  • update_site_option
  • update_site_option_{$key}
  • update_site_option_{$option}
  • updated_option
  • widget_customizer_setting_args
  • {$option}