Title: Image Placeholders Author: WordPress Performance Team Published: October 16, 2023 Last modified: February 27, 2026 --- Search plugins ![](https://ps.w.org/dominant-color-images/assets/banner-772x250.png?rev=3098225) ![](https://ps.w.org/dominant-color-images/assets/icon.svg?rev=3098225) # Image Placeholders By [WordPress Performance Team](https://profiles.wordpress.org/performanceteam/) [Download](https://downloads.wordpress.org/plugin/dominant-color-images.1.2.1.zip) * [Details](https://wordpress.org/plugins/dominant-color-images/#description) * [Reviews](https://wordpress.org/plugins/dominant-color-images/#reviews) * [Installation](https://wordpress.org/plugins/dominant-color-images/#installation) * [Development](https://wordpress.org/plugins/dominant-color-images/#developers) [Support](https://wordpress.org/support/plugin/dominant-color-images/) ## Description This plugin determines and stores the dominant color for newly uploaded images in the media library within WordPress and then uses it to create a placeholder background of that color in the frontend, visible until the image is loaded. _This plugin was formerly known as Dominant Color Images._ ## Installation #### Installation from within WordPress 1. Visit **Plugins > Add New**. 2. Search for **Image Placeholders**. 3. Install and activate the **Image Placeholders** plugin. #### Manual installation 1. Upload the entire `dominant-color-images` folder to the `/wp-content/plugins/` directory. 2. Visit **Plugins**. 3. Activate the **Image Placeholders** plugin. ## FAQ ### Where can I submit my plugin feedback? Feedback is encouraged and much appreciated, especially since this plugin may contain future WordPress core features. If you have suggestions or requests for new features, you can [submit them as an issue in the WordPress Performance Team’s GitHub repository](https://github.com/WordPress/performance/issues/new/choose). If you need help with troubleshooting or have a question about the plugin, please [create a new topic on our support forum](https://wordpress.org/support/plugin/dominant-color-images/#new-topic-0). ### Where can I report security bugs? The Performance team and WordPress community take security bugs seriously. We appreciate your efforts to responsibly disclose your findings, and will make every effort to acknowledge your contributions. To report a security issue, please visit the [WordPress HackerOne](https://hackerone.com/wordpress) program. ### How can I contribute to the plugin? Contributions are always welcome! Learn more about how to get involved in the [Core Performance Team Handbook](https://make.wordpress.org/performance/handbook/get-involved/). ## Reviews ![](https://secure.gravatar.com/avatar/a3159534f7faa2f0c2329bd9ac277f3682d7a0d91e1d27da68089ccc643b0c5e? s=60&d=retro&r=g) ### 󠀁[Works exactly as advertised](https://wordpress.org/support/topic/works-exactly-as-advertised-43/)󠁿 [Fabian Kaegy](https://profiles.wordpress.org/fabiankaegy/) January 30, 2025 This is such a nice enhancement for any site! ![](https://secure.gravatar.com/avatar/81d6cd29d711b1b8f768e3f31b7493de331a70168494303d83b73c2dbeca125c? s=60&d=retro&r=g) ### 󠀁[does nothing](https://wordpress.org/support/topic/does-nothing-139/)󠁿 [audioscavenger](https://profiles.wordpress.org/audioscavenger/) November 5, 2024 1 reply does not break the site, but all placeholders are grey. color detection does not work. I host WP docker latest myself with nginx and imageick + gd + webp + AVIF so yeah i think my setup is not in cause [ Read all 2 reviews ](https://wordpress.org/support/plugin/dominant-color-images/reviews/) ## Contributors & Developers “Image Placeholders” is open source software. The following people have contributed to this plugin. Contributors * [ WordPress Performance Team ](https://profiles.wordpress.org/performanceteam/) * [ WordPress.org ](https://profiles.wordpress.org/wordpressdotorg/) “Image Placeholders” has been translated into 16 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/dominant-color-images/contributors) for their contributions. [Translate “Image Placeholders” into your language.](https://translate.wordpress.org/projects/wp-plugins/dominant-color-images) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/dominant-color-images/), check out the [SVN repository](https://plugins.svn.wordpress.org/dominant-color-images/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/dominant-color-images/) by [RSS](https://plugins.trac.wordpress.org/log/dominant-color-images/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.2.1 **Bug Fixes** * Only attempt to get dominant colour for image mime types. ([2264](https://github.com/WordPress/performance/pull/2264)) #### 1.2.0 **Enhancements** * Enhance admin media UI with dominant color support. ([1719](https://github.com/WordPress/performance/pull/1719)) #### 1.1.2 **Enhancements** * Use more robust HTML Tag Processor for Image Placeholders. ([1477](https://github.com/WordPress/performance/pull/1477)) **Bug Fixes** * Re-remove unneeded phpcs:ignore. ([1231](https://github.com/WordPress/performance/pull/1231)) * Update PHPStan to 1.11.5. ([1318](https://github.com/WordPress/performance/pull/1318)) #### 1.1.1 **Enhancements** * Avoid needless array allocation in rgb to hex conversion. ([1104](https://github.com/WordPress/performance/pull/1104)) * Improve overall code quality with stricter static analysis checks. ([775](https://github.com/WordPress/performance/issues/775)) * Bump minimum PHP requirement to 7.2. ([1130](https://github.com/WordPress/performance/pull/1130)) **Bug Fixes** * Fix Imagick detecting partial transparency. ([1215](https://github.com/WordPress/performance/pull/1215)) #### 1.1.0 * Rename plugin to “Image Placeholders”. ([1101](https://github.com/WordPress/performance/pull/1101)) * Use plugin slug for generator tag. ([1103](https://github.com/WordPress/performance/pull/1103)) * Bump minimum required WP version to 6.4. ([1062](https://github.com/WordPress/performance/pull/1062)) * Update tested WordPress version to 6.5. ([1027](https://github.com/WordPress/performance/pull/1027)) #### 1.0.1 * Exclude “.wordpress-org” directory when deploying standalone plugins. ([866](https://github.com/WordPress/performance/pull/866)) #### 1.0.0 * Initial release of the Image Placeholders plugin as a standalone plugin. ([704](https://github.com/WordPress/performance/pull/704)) ## Community plugin This plugin is developed and supported by a community. [Contribute to this plugin](https://github.com/WordPress/performance) ## Meta * Version **1.2.1** * Last updated **5 months ago** * Active installations **60,000+** * WordPress version ** 6.6 or higher ** * Tested up to **7.0.2** * PHP version ** 7.2 or higher ** * Languages * [Chinese (Taiwan)](https://tw.wordpress.org/plugins/dominant-color-images/), [Danish](https://da.wordpress.org/plugins/dominant-color-images/), [Dutch](https://nl.wordpress.org/plugins/dominant-color-images/), [English (Australia)](https://en-au.wordpress.org/plugins/dominant-color-images/), [English (UK)](https://en-gb.wordpress.org/plugins/dominant-color-images/), [English (US)](https://wordpress.org/plugins/dominant-color-images/), [French (France)](https://fr.wordpress.org/plugins/dominant-color-images/), [German](https://de.wordpress.org/plugins/dominant-color-images/), [Korean](https://ko.wordpress.org/plugins/dominant-color-images/), [Persian](https://fa.wordpress.org/plugins/dominant-color-images/), [Portuguese (Brazil)](https://br.wordpress.org/plugins/dominant-color-images/), [Portuguese (Portugal)](https://pt.wordpress.org/plugins/dominant-color-images/), [Spanish (Chile)](https://cl.wordpress.org/plugins/dominant-color-images/), [Spanish (Spain)](https://es.wordpress.org/plugins/dominant-color-images/), [Swedish](https://sv.wordpress.org/plugins/dominant-color-images/), [Turkish](https://tr.wordpress.org/plugins/dominant-color-images/), and [Vietnamese](https://vi.wordpress.org/plugins/dominant-color-images/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/dominant-color-images) * Tags * [dominant color](https://wordpress.org/plugins/tags/dominant-color/)[images](https://wordpress.org/plugins/tags/images/) [performance](https://wordpress.org/plugins/tags/performance/) * [Advanced View](https://wordpress.org/plugins/dominant-color-images/advanced/) ## Ratings 3.5 out of 5 stars. * [ 1 5-star review ](https://wordpress.org/support/plugin/dominant-color-images/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/dominant-color-images/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/dominant-color-images/reviews/?filter=3) * [ 1 2-star review ](https://wordpress.org/support/plugin/dominant-color-images/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/dominant-color-images/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/dominant-color-images/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/dominant-color-images/reviews/) ## Contributors * [ WordPress Performance Team ](https://profiles.wordpress.org/performanceteam/) * [ WordPress.org ](https://profiles.wordpress.org/wordpressdotorg/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/dominant-color-images/)