diff --git a/docs/en/02_Developer_Guides/14_Files/02_Images.md b/docs/en/02_Developer_Guides/14_Files/02_Images.md index 6b9d60ec5..f2110c216 100644 --- a/docs/en/02_Developer_Guides/14_Files/02_Images.md +++ b/docs/en/02_Developer_Guides/14_Files/02_Images.md @@ -200,6 +200,19 @@ SilverStripe\Core\Injector\Injector: Quality: 90 ``` +### Lazy Loading + +Images added via the WYSIWYG editor and as objects on templates are [lazy loaded](https://developer.mozilla.org/en-US/docs/Web/Performance/Lazy_loading) by default. + +To disable lazy loading for an individual image, you can call `$MyImage.setLazyLoad(false)`. + +You can opt out of lazy loading globally by setting the `Image::lazy_loading_enabled` config to `false`, see example `yml`: + +```yml +SilverStripe\Assets\Image: + lazy_loading_enabled: false +``` + ## Changing the manipulation driver to Imagick If you want to change the image manipulation driver to use Imagick instead of GD, you'll need to change your config so