register_default_headers( array $headers )

Registers a selection of default headers to be displayed by the custom header admin UI.


Array of headers keyed by a string ID. The IDs point to arrays containing 'url', 'thumbnail_url', and 'description' keys.

More Information

  • The parameter $headers is required to merge with already registered headers.
  • This function is needed in order to use custom headers. The header image(s) must first be registered before using it.


function register_default_headers( $headers ) {
	global $_wp_default_headers;

	$_wp_default_headers = array_merge( (array) $_wp_default_headers, (array) $headers );



User Contributed Notes

  1. Skip to note 2 content


    Edit the file functions.php inside your theme and add the following code, replacing the images and descriptions where required.
    The %s is replaced with your themes path, so place the images in your theme directory.

    register_default_headers( array(
    	'wheel' => array(
    		'url'           => '%s/images/headers/wheel.jpg',
    		'thumbnail_url' => '%s/images/headers/wheel-thumbnail.jpg',
    		'description'   => __( 'Wheel', 'twentyeleven' )
    	'shore' => array(
    		'url'           => '%s/images/headers/shore.jpg',
    		'thumbnail_url' => '%s/images/headers/shore-thumbnail.jpg',
    		'description'   => __( 'Shore', 'twentyeleven' )
    	'trolley' => array(
    		'url'           => '%s/images/headers/trolley.jpg',
    		'thumbnail_url' => '%s/images/headers/trolley-thumbnail.jpg',
    		'description'   => __( 'Trolley', 'twentyeleven' )
    ) );

    Note: The code above was lifted from the TwentyEleven theme files.

    To reference a image in a child theme (ie in the stylesheet directory), use %2$s instead of %s.

    register_default_headers( array(
    	'child' => array(
    		'url'           => '%2$s/images/headers/child.jpg',
    		'thumbnail_url' => '%2$s/images/headers/child-thumbnail.jpg',
    		'description'   => __( 'Child', 'twentyeleven' )
    ) );

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