Starting with WooCommerce 10.6, all images from the Product Image block are lazy loaded by default. This was a long-requested change (see issue #42390).
The default behavior can be customized with the new woocommerce_product_image_loading_attr filter. It filters the loading attribute for product images.
Parameters:
string $loading_attr– The loading attribute. Default'lazy'.int $image_id– Target image ID.
Allowed values: lazy, eager, and auto. Any other value will result in default browser behavior.
How can developers tell if they are affected?
If your store uses the Product Image block, this change will affect you. Product images will now be lazy loaded by default, which can improve initial page load performance.
What action do developers need to take if affected?
In most cases, no action is needed—lazy loading is the recommended behavior for performance. However, if you need to change the loading behavior (for example, to eager load above-the-fold images), use the new woocommerce_product_image_loading_attr filter.
This change will be included in WooCommerce 10.6, currently scheduled for March 10, 2026.
Related PR: woocommerce/woocommerce#62829
Leave a Reply