WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

wp_img_tag_add_loading_attr

apply_filters ( ‘wp_img_tag_add_loading_attr’, string|bool $value , string $image , string $context  )

In this article

Back to top

Filters the loading attribute value to add to an image. Default lazy .

Description

Returning false or an empty string will not add the attribute.
Returning true will add the default value.

Parameters

$value string | bool
The loading attribute value. Returning a falsey value will result in the attribute being omitted for the image.
$image string
The HTML img tag to be filtered.
$context string
Additional context about how the function was called or where the img tag is.

Source

 $filtered_loading_attr = apply_filters( 'wp_img_tag_add_loading_attr', isset( $optimization_attrs['loading'] ) ? $ optimization_attrs['loading'] : false, $image, $context );

View all references View on Trac View on GitHub

Used by Description
wp_img_tag_add_loading_optimization_attrs() wp-includes/media.php

Adds optimization attributes to an img HTML tag.

wp_img_tag_add_loading_attr() wp-includes/deprecated.php

Adds loading attribute to an img HTML tag.

Changelog

Version Description
5.5.0 Introduced.

User Contributed Notes

  1. Skip to note 2 content
    Kresimir Pendic
    You must log in to vote on the helpfulness of this note Vote results for this note: zero You must log in to vote on the helpfulness of this note

    tl;dr ⨪ this will fix your LCP in pagespeed report for lazy loaded images above the fold

    This filter is very useful for images above the fold that don’t need to be lazy loaded (for example logos, featured images etc) so we can hook this filter to read our images and parse for example some custom class that can set lazy loading attribute ON or OFF per image.

    – by setting custom class `skip-lazy` inside admin under `Advanced > Additional Classes` inside image settings:

     add_filter( 'wp_img_tag_add_loading_attr', function( $value, $image ){ if ( false !==  strpos( $image, 'skip-lazy' ) ){ return false; } return true; }, 10, 2 );

    disables it

You must log in before being able to contribute a note or feedback.