A WordPress-centric search engine for devs and theme authors

wp_determine_option_autoload_value › WordPress Function

wp_determine_option_autoload_value ( $option, $value, $serialized_value, $autoload )
  • private
Parameters: (4)
  • (string) $option The name of the option.
    Required: Yes
  • (mixed) $value The value of the option to check its autoload value.
    Required: Yes
  • (mixed) $serialized_value The serialized value of the option to check its autoload value.
    Required: Yes
  • (bool|null) $autoload The autoload value to check. Accepts 'on'|true to enable or 'off'|false to disable, or 'auto-on', 'auto-off', or 'auto' for internal purposes. Any other autoload value will be forced to either 'auto-on', 'auto-off', or 'auto'. 'yes' and 'no' are supported for backward compatibility.
    Required: Yes
  • (string) Returns the original $autoload value if explicit, or 'auto-on', 'auto-off', or 'auto' depending on default heuristics.
Defined at:

Determines the appropriate autoload value for an option based on input.

This function checks the provided autoload value and returns a standardized value ('on', 'off', 'auto-on', 'auto-off', or 'auto') based on specific conditions. If no explicit autoload value is provided, the function will check for certain heuristics around the given option. It will return auto-on to indicate autoloading, auto-off to indicate not autoloading, or auto if no clear decision could be made.


function wp_determine_option_autoload_value( $option, $value, $serialized_value, $autoload ) {

	// Check if autoload is a boolean.
	if ( is_bool( $autoload ) ) {
		return $autoload ? 'on' : 'off';

	switch ( $autoload ) {
		case 'on':
		case 'yes':
			return 'on';
		case 'off':
		case 'no':
			return 'off';

	 * Allows to determine the default autoload value for an option where no explicit value is passed.
	 * @since 6.6.0
	 * @param bool|null $autoload The default autoload value to set. Returning true will be set as 'auto-on' in the
	 *                            database, false will be set as 'auto-off', and null will be set as 'auto'.
	 * @param string    $option   The passed option name.
	 * @param mixed     $value    The passed option value to be saved.
	$autoload = apply_filters( 'wp_default_autoload_value', null, $option, $value, $serialized_value );
	if ( is_bool( $autoload ) ) {
		return $autoload ? 'auto-on' : 'auto-off';

	return 'auto';