WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

get_random_header_image()

get_random_header_image(): string

In this article

Back to top

Gets random header image URL from registered images in theme.

Return

string Path to header image.

Source

function get_random_header_image() {
	$random_image = _get_random_header_data();

	if ( empty( $random_image->url ) ) {
		return '';
	}

	return $random_image->url;
}

View all references View on Trac View on GitHub

UsesDescription
_get_random_header_data()wp-includes/theme.php

Gets random header image data from registered images in theme.

Used byDescription
get_header_image()wp-includes/theme.php

Retrieves header image for custom header.

is_random_header_image()wp-includes/theme.php

Checks if random header image is in use.

Changelog

VersionDescription
3.2.0Introduced.

User Contributed Notes

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