I'm using add_theme_support( 'custom-header', $defaults ); to support custom header images in my theme. The $defaults are described in the Custom Headers article

$defaults = array(
    'default-image'          => '',
    'random-default'         => false,
    'width'                  => 0,
    'height'                 => 0,
    'flex-height'            => false,
    'flex-width'             => false,
    'default-text-color'     => '',
    'header-text'            => true,
    'uploads'                => true,
    'wp-head-callback'       => '',
    'admin-head-callback'    => '',
    'admin-preview-callback' => '',

There is no explanation in the Codex for the following. What do they mean?

  • wp-head-callback
  • admin-head-callback
  • admin-preview-callback

1 Answer 1


Those are name of callback function which would be enabled for custom header.

For example: if custom_function is assigned to 'wp-head-callback' then, there would be an action call like:


custom_function is the function you need to define.

  • Hi @Nilambar - thanks, I am aware of how callbacks work. I should have asked what is the point of having these callbacks? What should these callbacks actually do? Commented Jun 19, 2014 at 11:10
  • ok :-). That is the feature given by WP for us to extend to our imagination. Lets say, we want to animate or ease the image on hover of header image, then those scripts could be placed in the callback function. Just my poor imagination. :D Commented Jun 19, 2014 at 11:15
  • Why would I use wp-head-callback over admin-head-callback or admin-preview-callback? What's the difference? Commented Jun 19, 2014 at 12:35
  • wp_head is related with frontend template whereas admin_head is for admin side. They are pretty different. Commented Jun 19, 2014 at 17:41

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.