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

See also See also

Top ↑

Parameters Parameters


(string) (Required) A settings group name. Should correspond to a whitelisted option key name. Default whitelisted option key names include "general," "discussion," and "reading," among others.


(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.