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.

Custom Header Images


This plugin provides an easy, lightweight possibility to add header images to your blog. It is simple and clean.
It is easy to understand, maintain and extend. It does not make use of extra tables or buggy built-in uploads.


  • Simple and easy management of header images
  • Each possible state is covered, by using all elements of the WordPress template hierarchy
  • The Media Library is used for image management, images are saved by URL copy/paste (so external images can be used, too)
  • Requires no extra tables
  • Support for Custom Post Types (Single Custom Post Images) and Custom Taxonomies (Taxonomy Page Images)
  • NEW (1.1.0): Linked Header Images (e.g. category page, larger image version, whatever you want …)
  • NEW (1.1.0): Display Category Image by default
  • NEW (1.1.0): Full output customization
  • NEW (1.1.0): Exclude specified Taxonomies / Post Types from Header Image functionality
  • NEW (1.1.0): Internationalization (incl. English / German translation)
  • NEW (1.2.0): Added API to retrieve plain URL/Link and output
  • NEW (1.2.0): Added possibility to use relative URLs.
  • NEW (1.2.0): Added Custom Header Images for author pages.
  • Clean install/uninstall

en_US (default)
de_DE: German
sr_RS: Serbian (translation by

Please report any bugs you may encounter.

Plugin URL:


  1. Upload the Plugin to your wp-content/plugins/ folder
  2. Activate the Plugin
  3. Go to Settings -> Header Images and insert the image URLs (get the URLs from the media library)
  4. Paste the following code into your theme: <?php if(function_exists('chi_display_header')) { chi_display_header(); } ?>

Where to set the image data:

  • Go to Settings -> Header Images for general settings
  • Meta Boxes at the bottom of post / page / custom post type edit screen
  • Category/Taxonomy add/edit screen

Note: This Plugin uses conditional tags. You can only use conditional query tags after the posts_selection action hook in WordPress (the wp action hook is the first one through which you can use these conditionals). For themes, this means the conditional tag will never work properly if you are using it in the body of functions.php, i.e. outside of a function (


  • Q: The Plugin is not displaying the header images correctly. What is wrong?
    1. The function code must be pasted into one of your template files, the best place in most cases of use is the bottom of header.php
    1. This Plugin uses conditional tags. Please make sure that your WP_Query object has been loaded correctly, before the code is executed.


There are no reviews for this plugin.

Contributors & Developers

“Custom Header Images” is open source software. The following people have contributed to this plugin.


Translate “Custom Header Images” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Added language sr_RS (translation by


  • Added API to retrieve plain URL/Link and output
  • Added possibility to use relative URLs.
  • Added Custom Header Images for author pages.
  • Fixed installation problem with WP_DEBUG true (for new installations)


  • Display Category Images by Default
  • Linked Header Images
  • Full Output customization
  • Exclude specified Post Types / Taxonomies from Header Image functionality
  • Internationalization


  • Fixed Taxonomy editing bug


  • Added full support for Custom Post Types and Custom Taxonomies
  • Various improvements in routing, fixed category image bug.
  • Fixed some language issues.


  • Initial release.