Title: WP Display Header
Author: Konstantin Obenland
Published: March 28, 2011
Last modified: October 28, 2023
---
Search plugins
This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.
# WP Display Header
By [Konstantin Obenland](https://profiles.wordpress.org/obenland/)
[Download](https://downloads.wordpress.org/plugin/wp-display-header.7.zip)
* [Details](https://wordpress.org/plugins/wp-display-header/#description)
* [Reviews](https://wordpress.org/plugins/wp-display-header/#reviews)
* [Installation](https://wordpress.org/plugins/wp-display-header/#installation)
* [Development](https://wordpress.org/plugins/wp-display-header/#developers)
[Support](https://wordpress.org/support/plugin/wp-display-header/)
## Description
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.
Thanks to Erik T. for the idea to this plugin!
## Screenshots
* [[
* The meta box in the main column.
* [[
* The meta box in the side column.
## Installation
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
## FAQ
### 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:
```
; ?>)
```
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.
## Reviews
### [Simple and efficient](https://wordpress.org/support/topic/simple-and-efficient-221/)
[pouicpouic](https://profiles.wordpress.org/pouicpouic/) May 2, 2019
This plugin does exactly what it promises, smooth and problem free.
### [Does a fine job](https://wordpress.org/support/topic/does-a-fine-job-2/)
[fuchsr](https://profiles.wordpress.org/fuchsr/) March 23, 2019
On my site I like to show a different hero graphic on each page, reflecting the
specific contents of that page. The theme I’m using doesn’t allow me to choose different
header images. It uses the same on all pages. I tried a lot of plugins but this
one was the only one that truly did the job. I found a couple of issues eg a header
image is available for selection but when I select it, the page shows the default
header instead. I was able to “fix” these issues but deleting the header images
and re-uploading them. Would love to see an option to randomly pick headers based
on categories. Eg, I’d like one page to display a header picked from “Category A”
and another page show a header from “Category B”, with the headers randomly picked
from each respective category when pages are loaded.
### [Perfectly integrated in WP, works great](https://wordpress.org/support/topic/perfectly-integrated-in-wp-works-great/)
[kingbolo](https://profiles.wordpress.org/kingbolo/) January 22, 2019
One of the best plugins for this job. Integrates perfectly in WordPress and it looks
that it belongs there. (and probably should).
### [Only uploading could be improved](https://wordpress.org/support/topic/only-uploading-could-be-improved/)
[Sudrien](https://profiles.wordpress.org/sudrien/) January 19, 2019
WP Display Header works with the standard header_image(); system. As of 5.0.3, UPLOADING
header images seems a bit inconsistent, as it does not seem you can do that while
editing a page, but otherwise works well.
### [Nice Plugin – Just works](https://wordpress.org/support/topic/nice-plugin-just-works/)
[Dennis Booker](https://profiles.wordpress.org/dabooker/) April 23, 2018
I’ve looked through lots of postings and articles to find a way to have custom headers
and this plugin does just that. I’m using WP 4.9.5 and theme Twenty Seventeen and
no problems. Thanks.
### [Works great on WordPress.com](https://wordpress.org/support/topic/does-not-work-at-all-on-wordpress-com/)
[r6123603680](https://profiles.wordpress.org/r6123603680/) October 27, 2017
Initially, I thought this was yet another plugin featured in the plugin directory
for WordPress.com doesn’t actually work there. As it turns out, it works perfectly
but you have to edit your pages through the legacy wp-admin console, not the main
editor. It works great – you just select “none” for the header image and voila!
[ Read all 28 reviews ](https://wordpress.org/support/plugin/wp-display-header/reviews/)
## Contributors & Developers
“WP Display Header” is open source software. The following people have contributed
to this plugin.
Contributors
* [ Konstantin Obenland ](https://profiles.wordpress.org/obenland/)
“WP Display Header” has been translated into 2 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/wp-display-header/contributors)
for their contributions.
[Translate “WP Display Header” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-display-header)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/wp-display-header/),
check out the [SVN repository](https://plugins.svn.wordpress.org/wp-display-header/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wp-display-header/)
by [RSS](https://plugins.trac.wordpress.org/log/wp-display-header/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 7
* Fixes a bug where posts pages would not load their assigned header image. See
https://github.com/obenland/wp-display-header/issues/3
* Updated utility class.
* Tested for WordPress 6.1.
#### 6
* Fixed a bug where srcset information for header images overrode custom header
selections.
#### 5
* Maintenance release.
* Updated code to adhere to WordPress Coding Standards.
* Tested for WordPress 5.0.
#### 4
* 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.
#### 3
* Maintenance release.
* Some minor code cleanups.
* Tested for WordPress 4.4.0.
#### 2.2.0
* Maintenance release.
* Some minor code cleanups.
* Tested for WordPress 4.0.
#### 2.1.0
* Added an option to not display a header at all.
* Updated utility class.
* Tested for WordPress 3.6.
#### 2.0.1
* Fixed a bug, where the fallback to the default header did not work. Props carloscorrela.
#### 2.0.0
* **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.
#### 1.5.3
* 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.
#### 1.5.2
* Fixed a bug, where a selected header wouldn’t override the default selection
on posts pages.
#### 1.5.1
* Specific headers can now be reverted by selecting the default header.
#### 1.5
* Adjusted meta box layout to WordPress core.
* Transfered CSS in external file.
* Updated FAQ section. Props Brian.
* Tested for WordPress 3.3.1.
#### 1.4
* Added support for WordPress 3.2 core header uploads.
#### 1.3
* 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.
#### 1.2.1
* WordPress Plugin Repository update bug.
#### 1.2
* Tested for WordPress 3.1.2.
* Now a custom folder name can be specified. See: Settings > Media.
* Added Italian translation. Props Pietro Rossi.
#### 1.1
* Tested for WordPress 3.1.1
* Adopted [WP Save Custom Header](https://wordpress.org/extend/plugins/wp-save-custom-header/)
multisite capability.
* Made HTML W3C valid.
#### 1.0
* Initial Release.
## Meta
* Version **7**
* Last updated **2 years ago**
* Active installations **7,000+**
* WordPress version ** 3.2 or higher **
* Tested up to **6.4.8**
* Languages
* [Dutch](https://nl.wordpress.org/plugins/wp-display-header/), [English (US)](https://wordpress.org/plugins/wp-display-header/),
and [Ukrainian](https://uk.wordpress.org/plugins/wp-display-header/).
* [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/wp-display-header)
* Tags
* [admin](https://wordpress.org/plugins/tags/admin/)[custom header](https://wordpress.org/plugins/tags/custom-header/)
[custom header image](https://wordpress.org/plugins/tags/custom-header-image/)
[header](https://wordpress.org/plugins/tags/header/)[header-image](https://wordpress.org/plugins/tags/header-image/)
* [Advanced View](https://wordpress.org/plugins/wp-display-header/advanced/)
## Ratings
4.5 out of 5 stars.
* [ 22 5-star reviews ](https://wordpress.org/support/plugin/wp-display-header/reviews/?filter=5)
* [ 1 4-star review ](https://wordpress.org/support/plugin/wp-display-header/reviews/?filter=4)
* [ 2 3-star reviews ](https://wordpress.org/support/plugin/wp-display-header/reviews/?filter=3)
* [ 0 2-star reviews ](https://wordpress.org/support/plugin/wp-display-header/reviews/?filter=2)
* [ 2 1-star reviews ](https://wordpress.org/support/plugin/wp-display-header/reviews/?filter=1)
[Add my review](https://wordpress.org/support/plugin/wp-display-header/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/wp-display-header/reviews/)
## Contributors
* [ Konstantin Obenland ](https://profiles.wordpress.org/obenland/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/wp-display-header/)
## Donate
Would you like to support the advancement of this plugin?
[ Donate to this plugin ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=MWUA92KA2TL6Q)