Search Over 30,000 FREE Plugins from the Official WordPress Plugin Directory Repository

WP Display Header

Select a specific header or random header image for each content item or archive page.

This plugin lets you specify a header image for each post, page, custom post type or archive page individually, from your default headers and custom headers.

It adds a meta box in the post edit screens with the header selection and a settings field in the edit profile and each taxonomy edit screen. If no specific header is specified for a post it will fall back to the default selection. There is no change of template files necessary as this plugin hooks in the existing WordPress API to unfold its magic.


I will be more than happy to update the plugin with new locales, as soon as I receive them! Currently available in:

  • English
  • Deutsch
  • Italiano

Thanks to Erik T. for the idea to this plugin!

Author Konstantin O
Contributors obenland
  1. wp-display-header screenshot 1

    The meta box in the main column.

  2. wp-display-header screenshot 2

    The meta box in the side column.

  1. Download WP Display Header.
  2. Unzip the folder into the /wp-content/plugins/ directory
  3. Activate the plugin through the 'Plugins' menu in WordPress


  • Fixed a bug where styles were not enqueued correctly in wp-admin.
  • Now correctly displays the selection for header images on term edit pages again.
  • Tested for WordPress 4.6.0.


  • Maintenance release.
  • Some minor code cleanups.
  • Tested for WordPress 4.4.0.


  • Maintenance release.
  • Some minor code cleanups.
  • Tested for WordPress 4.0.


  • Added an option to not display a header at all.
  • Updated utility class.
  • Tested for WordPress 3.6.


  • Fixed a bug, where the fallback to the default header did not work. Props carloscorrela.


  • IMPORTANT: Version 2.0.0 breaks compatibility with WordPress versions prior to 3.2!
  • Added the header selection field to Taxonomy and Author Edit screens.
  • Fixed a minor bug for themes that have no header images registered.


  • Improved user experience when current theme does not support custom headers, on activation of the plugin.
  • Deprecated settings functions for WP Save Custom Header in preparation for overhaul in v2.0.0.
  • Updated utility class.


  • Fixed a bug, where a selected header wouldn't override the default selection on posts pages.


  • Specific headers can now be reverted by selecting the default header.


  • Adjusted meta box layout to WordPress core.
  • Transfered CSS in external file.
  • Updated FAQ section. Props Brian.
  • Tested for WordPress 3.3.1.


  • Added support for WordPress 3.2 core header uploads.


  • Tested for WordPress 3.2-beta
  • Fixed a minor bug where a PHP warning was issued in the edit-post-screen, when there are no header images registered.


  • WordPress Plugin Repository update bug.


  • Tested for WordPress 3.1.2.
  • Now a custom folder name can be specified. See: Settings > Media.
  • Added Italian translation. Props Pietro Rossi.



  • Initial Release.

What do I need in the `header.php` file to make the plugin work seamlessly?

To make it work in your header.php file all you need is a header_image() call like so:

<img src="<?php header_image(); ?>" width="<?php echo get_custom_header()->width; ?>" height="<?php echo get_custom_header()->height; ?>" alt="" />

See TwentyTwelve's header.php for reference.

Plugin Filter Hooks

wpdh_show_default_header (bool)

Whether to show the default header (true) or to look for a specifically selected header for the current request.

wpdh_get_header_posts (array)

All attachments with the meta key _header_image. An array with the query vars.

wpdh_get_headers (array)

The array with all registered headers.

wpdh_get_active_post_header (string)

The url to the currently active header image.

Version 4

Requires WordPress version: 3.2 or higher

Compatible up to: 4.6.0

Last Updated 22 Jul 2016

Date Added: 28 Mar 2011

Plugin Homepage


4.6 stars
18 ratings


Not Enough Data

Works: 0
Broken: 0

Probably Works.
Considering downloads, would expect problems reported.