Warning: This function has been deprecated. Use register_setting() instead.

add_option_update_handler( string $option_group, string $option_name, callable $sanitize_callback = '' )

Register a setting and its sanitization callback

Description Description

Top ↑

See also See also

Top ↑

Parameters Parameters


(string) (Required) A settings group name. Should correspond to an allowed option key name. Default allowed option key names include 'general', 'discussion', 'media', 'reading', 'writing', 'misc', 'options', and 'privacy'.


(string) (Required) The name of an option to sanitize and save.


(callable) (Optional) A callback function that sanitizes the option's value.

Default value: ''

Top ↑

Source Source

File: wp-admin/includes/deprecated.php

function add_option_update_handler( $option_group, $option_name, $sanitize_callback = '' ) {
	_deprecated_function( __FUNCTION__, '3.0.0', 'register_setting()' );
	register_setting( $option_group, $option_name, $sanitize_callback );

Top ↑

Changelog Changelog

Version Description
3.0.0 Use register_setting()
2.7.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.