Deprecated Deprecated

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

Summery Summery

Register a setting and its sanitization callback

Syntax Syntax

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

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: ''

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 );


Changelog Changelog

Version Description
3.0.0 Use register_setting()
2.7.0 Introduced.

See also See also


Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.