The Unique Headers Plugin adds a custom header image box to the post/page edit screen. You can use this to upload a unique header image for that post, or use another image from your WordPress media library. When you view that page on the front-end of your site, the default header image for your site will be replaced by the unique header you selected.

This functionality also works with categories and tags.


You must use a theme which utilizes the built-in custom header functionality of WordPress. If your theme implement it's own header functionality, then this plugin will not work with it.

Language support

The plugin includes translations for the following languages:

  1. Spanish - provided by Mariano J. Ponce
  2. German - provided by Tobias Klotz
  3. French - provided by Jenny Beaumont
  4. Swedish - provided by Alice Carlsson


Download the Unique Headers plugin.

After you've downloaded and extracted the files:

  1. Upload the complete 'unique-headers' folder to the '/wp-content/plugins/' directory OR install via the plugin installer
  2. Activate the plugin through the 'Plugins' menu in WordPress
  3. And yer done!

Now you will see a new custom header image uploader whilst editing posts, pages, tags or categories on your site.

Visit the Unique Headers Plugin for more information.

  1. unique-headers screenshot 1

    The new meta box as added to the posts/pages screen

  2. unique-headers screenshot 2

    The custom header image uploader for adding new header images

  3. unique-headers screenshot 3

    The new meta box for categories and tags.

Frequently asked questions

Do I need to install an extra plugin for categories/tags support?

No. This functionality previously required the Taxonomy Metadata plugin, but as of WordPress 4.4, that plugin is no longer required as terms meta was added to WordPress core. Your old categories and tags header images will be retained, but you should make sure that the taxonomy metadata plugin has upgraded your data before deactivating it.

Your plugin doesn't work

Actually, it does work ;) The problem is likely with your theme. Some themes have "custom headers", but don't use the built-in WordPress custom header system and will not work with the Unique Headers plugin because of this. It is not possible to predict how other custom header systems work, and so those can not be supported by this plugin. To test if this is the problem, simply switch to one of the default themes which come with WordPress and see if the plugin works with those, if it does, then your theme is at fault.

My theme doesn't work with your plugin, how do I fix it?

This is a complex question and not something I can teach in a short FAQ. I recommend hiring a professional WordPress developer for assistance, or asking the developer of your theme to add support for the built-in WordPress custom header system.

Does it work with custom post-types?

Not out of the box, but you can modify the following code to add support to suit your own requirements. You can can add this code to either your theme or to a custom plugin. You will need to modify the post-type to suit your own requirements. Some knowledge of PHP coding is necessary for this step.


 * Add support for a post-type called "some-post-type"
 * @param   array   $post_types   The currently supported post-types
 * @return  array   $post_types   The modified list of supported post-types
function unique_headers_add_post_type( $post_types ) {
    $post_types[] = 'some-post-type';

    return $post_types;
add_filter( 'unique_headers_post_types', 'unique_headers_add_post_type' );

Does it work with taxonomies?

As with custom post-types, not out of the box. You can however modify the following code to add support to suit your own requirements. You can can add this code to either your theme or to a custom plugin. You will need to modify the taxonomy to suit your own requirements. Some knowledge of PHP coding is necessary for this step.


 * Add support for a taxonomy called "some-taxonomy"
 * @param   array   $taxonomies   The currently supported taxonomies
 * @return  array   $taxonomies   The modified list of supported taxonomies
function unique_headers_add_taxonomy( $taxonomies ) {
    $taxonomies[] = 'some-taxonomy';
    return $taxonomies;
add_filter( 'unique_headers_taxonomies', 'unique_headers_add_taxonomy' );

Where's the plugin settings page?

There isn't one.

Other plugins work out the width and height of the header and serve the correct sized header. Why doesn't your plugin do that?

I prefer to allow you to set the width and height yourself by opening a correct sized image. This allows you to provide over-resolution images to cater for "retina screen" and zoomed in users. Plus, it allows you to control the compression and image quality yourself. Neither route is better in my opinion. If you require this functionality, please let me know though, as if most people prefer the other route, then I may change how the plugin works. I suspect most people won't care either way though.

Does it work in older versions of WordPress?

Mostly, but I only actively support the latest version of WordPress. Support for older versions is purely by accident. Versions prior to 4.4 will definitely not work with categories and tags.

I need custom functionality. Can we pay you to build it for us?

No, I'm too busy. Having said that, if you are willing to pay me a small fortune then I could probably be persuaded. I'm also open to suggestions for improvements, so feel free to send me ideas and if you are lucky, it may be added for free :)


Version 1.4.8: Fixing a bug triggered by WordPress assigning non-URL's as the URL. Version 1.4.7: Setting a more sane plugin review time. Version 1.4.6: Fixing bug with handling taxonomies. Added plugin review notice back, but without the non-existent MONTH_IN_SECONDS constant. Version 1.4.5: Removing plugin review notice due to unsolvable errors. Version 1.4.4: Adding plugin review class back, with correct time stamp set. Version 1.4.3: Temporarily removing plugin review class until bugs are fixed. Version 1.4.2: Adding a plugin review class. Version 1.4.1: Instantiating the plugin later (allows for adding additional post-types in themes). Version 1.4: Adding backwards compatibility to maintain header images provided by the Taxonomy metadata plugin. Version 1.3.12: Added French language translation. Version 1.3.11: Moved instantiation and localization code into a class. Version 1.3.10: Added Deutsch (German) language translation. Version 1.3.9: Fixing error which caused header images to disappear on upgrading (data was still available just not accessed correctly).
Version 1.3.8: Modification translation system to work with changes on WordPress.org.
Version 1.3.7: Addition of Spanish translation
Version 1.3.1: Adjustment to match post meta key to other plugins, for compatibilty reasons.
Version 1.3: Total rewrite to use custom built in system for media uploads. Also adapted taxonomies to use ID's and added support for extra post-types and taxonomies.
Version 1.2: Converted to use the class from the Multiple Featured Images plugin
Version 1.1: Added support for tags
Version 1.0.4: Added support for displaying a category specific image on the single post pages
Version 1.0.3: Correction for $new_url for categories
Version 1.0.2: Bug fix to allow default header to display when no category specified
Version 1.0.1: Bug fixes for post/page thumbnails
Version 1.0: Initial release


Thanks to the following for help with the development of this plugin:
* Todd - Assistance with implementing support for tags
* Mariano J. Ponce - Spanish translation
* Tobias Klotz - Deutsch (German) language translation. * Nadia Tokerud - Proof-reading of Norsk Bokmål (Norwegian) translation (coming soon)
* Bjørn Johansen - Proof-reading of Norwegian Bokmål translation (coming soon)
* Karl Olofsson - Proof-reading of Swedish translation (coming soon)
* Jenny Beaumont - French translation (coming soon)