get_site_option( string $option, mixed $default_value = false, bool $deprecated = true ): mixed

Retrieve an option value for the current network based on name of option.

Description

See also

Parameters

$optionstringrequired
Name of the option to retrieve. Expected to not be SQL-escaped.
$default_valuemixedoptional
Value to return if the option doesn’t exist.

Default:false

$deprecatedbooloptional
Whether to use cache. Multisite only. Always set to true.

Default:true

Return

mixed Value set for the option.

More Information

This function is almost identical to get_option(), except that in multisite, it returns the network-wide option. For non-multisite installs, it uses get_option.

It is easy to get confused about the difference between get_option() and get_site_option() , because multisite used different terms before. Now there are different “sites” on a “network”, before there where different “blogs” on a “site”. Many functions and variables were introduced before this change, such as this one. Think of this function as “get_network_option()

Source

function get_site_option( $option, $default_value = false, $deprecated = true ) {
	return get_network_option( null, $option, $default_value );
}

Changelog

VersionDescription
4.4.0Modified into wrapper for get_network_option()
2.8.0Introduced.

User Contributed Notes

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