Warning: This function has been deprecated. Use add_theme_support() instead.

add_custom_image_header( callable $wp_head_callback, callable $admin_head_callback, callable $admin_preview_callback = '' )

Add callbacks for image header display.

Description Description

See also See also

Top ↑

Parameters Parameters


(callable) (Required) Call on the 'wp_head' action.


(callable) (Required) Call on custom header administration screen.


(callable) (Optional) Output a custom header image div on the custom header administration screen. Optional.

Default value: ''

Top ↑

Source Source

File: wp-includes/deprecated.php

function add_custom_image_header( $wp_head_callback, $admin_head_callback, $admin_preview_callback = '' ) {
	_deprecated_function( __FUNCTION__, '3.4.0', 'add_theme_support( \'custom-header\', $args )' );
	$args = array(
		'wp-head-callback'    => $wp_head_callback,
		'admin-head-callback' => $admin_head_callback,
	if ( $admin_preview_callback )
		$args['admin-preview-callback'] = $admin_preview_callback;
	return add_theme_support( 'custom-header', $args );

Top ↑

Changelog Changelog

Version Description
3.4.0 Use add_theme_support()
2.1.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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