WordPress at a glance
function is not described

wp_safe_remote_head() WP 3.6.0

Retrieve the raw response from a safe HTTP request using the HEAD method.

This function is ideal when the HTTP request is being made to an arbitrary URL. The URL is validated to avoid redirection and request forgery attacks.

No Hooks.


Array|WP_Error. The response or WP_Error on failure.


wp_safe_remote_head( $url, $args );
$url(string) (required)
URL to retrieve.
Request arguments.
Default: empty array


  • See: wp_remote_request() For more information on the response array format.
  • See: WP_Http::request() For default arguments information.


Since 3.6.0 Introduced.

Code of wp_safe_remote_head() WP 5.7.2

function wp_safe_remote_head( $url, $args = array() ) {
	$args['reject_unsafe_urls'] = true;
	$http                       = _wp_http_get_object();
	return $http->head( $url, $args );