Title: LazyBlur Placeholder Addon for WP Rocket
Author: Ali Hussain
Published: <strong>October 2, 2026</strong>
Last modified: October 2, 2026

---

Search plugins

![](https://ps.w.org/lazyblur-for-wp-rocket/assets/banner-772x250.png?rev=3724391)

![](https://ps.w.org/lazyblur-for-wp-rocket/assets/icon-256x256.png?rev=3724378)

# LazyBlur Placeholder Addon for WP Rocket

 By [Ali Hussain](https://profiles.wordpress.org/alihs123/)

[Download](https://downloads.wordpress.org/plugin/lazyblur-for-wp-rocket.1.0.0.zip)

 * [Details](https://wordpress.org/plugins/lazyblur-for-wp-rocket/#description)
 * [Reviews](https://wordpress.org/plugins/lazyblur-for-wp-rocket/#reviews)
 *  [Installation](https://wordpress.org/plugins/lazyblur-for-wp-rocket/#installation)
 * [Development](https://wordpress.org/plugins/lazyblur-for-wp-rocket/#developers)

 [Support](https://wordpress.org/support/plugin/lazyblur-for-wp-rocket/)

## Description

You satisfied Google’s performance guidance by lazy-loading offscreen images, but
visitors may still see empty image areas while those files load. LazyBlur Placeholder
Addon for WP Rocket fills those spaces with a tiny preview of the final image.

The plugin uses the Low Quality Image Placeholder (LQIP) technique. It generates
a small image when media is uploaded, stores it as a base64 data URI, and displays
it through WP-Rocket’s LazyLoad markup until the full image is ready. The preview
then sharpens into the final image with a one-second transition.

This improves perceived loading and gives visitors visual context immediately. It
complements image lazy loading and Core Web Vitals work; it does not guarantee search
rankings or performance scores.

#### Features

 * Generates LQIP data automatically for new Media Library images.
 * Backfills placeholders for images uploaded before activation.
 * Works with WP-Rocket JavaScript and native image lazy loading.
 * Supports JPEG, PNG, GIF, and WebP attachments.
 * Resolves responsive sizes, scaled originals, and CDN-hosted uploads.
 * Optionally adds a placeholder to the first above-the-fold image.
 * Preserves responsive `srcset` data and provides no-JavaScript fallbacks.
 * Applies an accessible reduced-motion-safe fade from preview to full image.
 * Caches local LQIP previews for WP-Rocket YouTube placeholders.
 * Provides coverage statistics, integration checks, and a live preview.
 * Includes filters for custom attachment resolution and final image markup.

#### SEO and user experience

Lazy loading helps reduce initial page weight, but an empty placeholder can make
a page feel unfinished. LQIP keeps the layout visually populated while deferred 
images load, helping users understand the page sooner.

The plugin preserves image dimensions and responsive sources. The optional first-
image setting is disabled by default because replacing an above-the-fold image can
affect Largest Contentful Paint. Test that option against your own Core Web Vitals
data before enabling it in production.

#### Requirements

 * WordPress 5.6 or later.
 * PHP 7.4 or later.
 * WP-Rocket with LazyLoad for images enabled to display image placeholders.
 * WP-Rocket LazyLoad for iframes and videos, plus YouTube preview replacement, 
   for YouTube LQIP support.

### External services

The optional YouTube preview feature requests thumbnail images from `i.ytimg.com`
using the video ID already present in the page content. The thumbnail is downloaded
when a post is saved or through a scheduled background task, then stored locally
in the WordPress Media Library.

This service is provided by YouTube/Google and is subject to the [YouTube Terms of Service](https://www.youtube.com/t/terms)
and [Google Privacy Policy](https://policies.google.com/privacy). No request is 
made when YouTube preview support is disabled or no YouTube video is present.

## Screenshots

[⌊Image placeholder settings, including width, quality, and first-image controls.⌉⌊
Image placeholder settings, including width, quality, and first-image controls.⌉[

Image placeholder settings, including width, quality, and first-image controls.

[⌊Media Library coverage statistics and the backfill tool.⌉⌊Media Library coverage
statistics and the backfill tool.⌉[

Media Library coverage statistics and the backfill tool.

[⌊Side-by-side placeholder and full-image preview.⌉⌊Side-by-side placeholder and
full-image preview.⌉[

Side-by-side placeholder and full-image preview.

[⌊WP-Rocket integration requirements and YouTube preview settings.⌉⌊WP-Rocket integration
requirements and YouTube preview settings.⌉[

WP-Rocket integration requirements and YouTube preview settings.

## Installation

 1. Upload the `lazyblur-for-wp-rocket` folder to `/wp-content/plugins/`, or install
    the plugin ZIP through **Plugins > Add New > Upload Plugin**.
 2. Activate **LazyBlur Placeholder Addon for WP Rocket**.
 3. In WP-Rocket, enable **LazyLoad for images** under **Settings > WP-Rocket > Media**.
 4. Open **Settings > LazyBlur**.
 5. Configure placeholder width and compression quality.
 6. Run the backfill tool if the Media Library contains images uploaded before activation.
 7. Clear the WP-Rocket cache and test the front end while logged out.

## FAQ

### Does this replace WP-Rocket?

No. This plugin extends WP-Rocket’s LazyLoad output. WP-Rocket remains responsible
for deciding which images are lazy-loaded and when the full files are loaded.

### What problem does LQIP solve?

Standard lazy loading can leave an empty or generic placeholder before an image 
enters the viewport. LQIP displays a recognizable, lightweight preview during that
interval.

### Are placeholders generated for existing images?

Use the backfill tool under **Settings > LazyBlur**. It processes the Media Library
in small batches to reduce timeout risk.

### Does it work with CDN or resized image URLs?

Yes. The plugin resolves WordPress intermediate sizes, `-scaled` originals, and 
upload paths served from a different CDN hostname.

### Can it add a placeholder to the first image?

Yes. Enable **Include the first image** in the settings. This option can affect 
Largest Contentful Paint, so measure the result before using it on a production 
site.

### Does it support native lazy loading?

Yes. The real `src` and `srcset` are restored near the viewport using a small IntersectionObserver
script. A no-JavaScript fallback retains access to the original image.

### What happens when JavaScript is disabled?

Images converted by the native or first-image modes include their original markup
in a `noscript` fallback.

### Can developers customize the output?

Use `wrlqip_final_image_html` to filter completed image markup. Use `wrlqip_pre_attachment_id_from_url`
to provide an attachment ID for custom CDN or offload URLs.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“LazyBlur Placeholder Addon for WP Rocket” is open source software. The following
people have contributed to this plugin.

Contributors

 *   [ Ali Hussain ](https://profiles.wordpress.org/alihs123/)

[Translate “LazyBlur Placeholder Addon for WP Rocket” into your language.](https://translate.wordpress.org/projects/wp-plugins/lazyblur-for-wp-rocket)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/lazyblur-for-wp-rocket/),
check out the [SVN repository](https://plugins.svn.wordpress.org/lazyblur-for-wp-rocket/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/lazyblur-for-wp-rocket/)
by [RSS](https://plugins.trac.wordpress.org/log/lazyblur-for-wp-rocket/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * Initial release.
 * Added image LQIP generation, backfill, native lazy-load support, optional first-
   image handling, fade transitions, and YouTube previews.

## Meta

 *  Version **1.0.0**
 *  Last updated **1 day ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.6 or higher **
 *  Tested up to **7.1.2**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [images](https://wordpress.org/plugins/tags/images/)[Lazy Loading](https://wordpress.org/plugins/tags/lazy-loading/)
   [performance](https://wordpress.org/plugins/tags/performance/)[wp-rocket](https://wordpress.org/plugins/tags/wp-rocket/)
 *  [Advanced View](https://wordpress.org/plugins/lazyblur-for-wp-rocket/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/lazyblur-for-wp-rocket/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/lazyblur-for-wp-rocket/reviews/)

## Contributors

 *   [ Ali Hussain ](https://profiles.wordpress.org/alihs123/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/lazyblur-for-wp-rocket/)