Add Custom Header Images
Remove default header images and load custom header images from 'The Headers' page. Allows for easy selection of random header images in your theme.
Solid choice
Add Custom Header Images is a solid plugin choice in 2026, with a few things worth checking first. It runs on 400+ sites, is rated 4.7/5 and was last updated 2 months ago, and scores 72/100 on our health check.
- Tested with the latest WordPress (7.1)
- Small user base (400+ active installs)
- Very few reviews so far
How does it stack up?
Side-by-side on installs, updates, ratings & support
Daily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where Add Custom Header Images stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| headers | #30 |
| images | #69 |
| rotate headers | #2 |
Version adoption
Share of active sites per release.
Rating breakdown
★★★★★★★★★★ 4.7 from 3 reviews
About Add Custom Header Images
From the official readme · v2.3.6Description
Remove default header images and load custom header images from ‘The Headers’ page. Allows for easy selection of random header images in your theme.
A plugin that should be able to remove default headers for a theme and add custom headers based upon the article written by Julio Biason who was inspired by wpti.ps.
Create a Page named The Headers. Then upload header images (media files) to the the page. The page may have a visibility of private. All images displayed on the page will be parsed, those attached to the page and those added via image blocks.
Once the custom header images are loaded, just go to Appearance > Header or Customize > Header Image and select Randomize suggested headers.
The plugin will display an error notice if there is not a page titled, The Headers.
Installation
- Create a new page. It can be private. It must be titled
The Headers. Add any images that you want to use as custom header images to this page. Header images should be cropped appropriately for the base theme. - Upload
add-custom-header-imagesdirectory to the/wp-content/plugins/directory - Activate the plugin through the ‘Plugins’ menu in WordPress
- Go to
Appearance > HeaderorCustomize > Header Imageand selectRandomizefrom the Default Images section.
Changelog
2.3.6 / 2026-08-13
- update GitHub Actions
- update tested to
2.3.5 / 2025-04-03
- add GA to generate POT
- change startup action hook to
after_setup_themefor translations
2.3.4 / 2024-11-01
- remove
load_plugin_textdomain()
2.3.3 / 2023-07-21
- use ‘all’ over ‘any’ in query, perhaps better
- call
wp_get_attachment_image()to populate specific attributes
2.3.2 / 2023-02-08
- improve WP_Query for single call
2.3.1 / 2023-02-08
- fix to use public or private pages
For developers
Is this your plugin? Show off the numbers.
Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.
Best Add Custom Header Images alternatives
All headers plugins →
FAQ
Add Custom Header Images: quick answers
Straight answers, pulled from live WordPress.org data.
Live data from WordPress.org · checked Oct 4, 2026
Is Add Custom Header Images free?
Yes. Add Custom Header Images is free to download and use from the official WordPress.org plugin directory.
Is Add Custom Header Images safe to use in 2026?
Add Custom Header Images is a solid plugin choice in 2026, with a few things worth checking first. It runs on 400+ sites, is rated 4.7/5 and was last updated 2 months ago, and scores 72/100 on our health check.
How many websites use Add Custom Header Images?
Add Custom Header Images is active on 400+ WordPress websites and has been downloaded 45,911 times since it launched in May 2014. It was downloaded 182 times in the last 30 days.
Does Add Custom Header Images work with WordPress 7.1?
Yes. The developer has tested Add Custom Header Images up to WordPress 7.1.2, the latest release. It requires WordPress 5.2 or newer.
What PHP version does Add Custom Header Images need?
Add Custom Header Images requires PHP 5.6 or higher. Most hosts run PHP 8.x today, so it works on any modern WordPress hosting.
When was Add Custom Header Images last updated?
The latest version, 2.3.6, was released on August 13, 2026 (2 months ago).
Who makes Add Custom Header Images?
Add Custom Header Images is developed and maintained by Andy Fragen.
What are the best alternatives to Add Custom Header Images?
The most popular alternatives to Add Custom Header Images are Headers Security Advanced &… (90K+ installs), WP Hide & Security Enhancer (50K+ installs) and Redirect (5K+ installs).
Powered by PageForge
Want thousands of pages that rank like these? Build them in an afternoon.
This directory runs on the same engine as PageForge. Turn any spreadsheet, CSV or API into thousands of fast, SEO-ready WordPress pages — with schema, internal links and AI-written copy baked in.
- CSV, Google Sheets & API data sources
- AI content, schema & internal links per page
- Works with Elementor, Gutenberg, Yoast & Rank Math
- Free on WordPress.org — no credit card
