# Magento 2 Lazy Load Image ### Installation and User Guide for Magento 2 Lazy Load Image **Table of Contents** 1. [Installation](#bkmrk-installation) - Installation via app/code - Installation via Composer 2. [Configuration Settings for Optimiser Base](#bkmrk-configuration-settin) - General Settings 3. [Configuration Settings for Lazy Loading](#bkmrk-configuration-settin-1) - General Settings 4. [Front-end Screenshots](#bkmrk-front-end-screenshot) - Lazy Loading on the Homepage - Home Page Excluded from Lazy Loading - Lazy Loading on the Category Page - Lazy Loading on the Search Page - Lazy Loading on the Cart Page. ### Installation [](#bkmrk-) - **Installation via app/code:** Upload the content of the module to your root folder. This will not overwrite the existing Magento folder or files, only the new contents will be added. After the successful upload of the package, run below commands on Magento 2 root directory. ```php php bin/magento setup:upgrade  php bin/magento setup:di:compile php bin/magento setup:static-content:deploy ``` - **Installation via Composer:** Please follow the guide provided in the below link to complete the installation via composer.

[https://docs.scommerce-mage.com/magento-2-extensions/installation-via-composer/installation-via-composer](https://docs.scommerce-mage.com/magento-2-extensions/installation-via-composer/installation-via-composer)

### Configuration Settings for Optimiser Base [](#bkmrk--1) Go to **Admin > Stores > Configuration > Scommerce Configuration > Optimiser Base** #### General Settings [](#bkmrk--2) - **Enabled –** Select "Yes" or "No" to enable or disable the module. - **License Key –** Please add the license for the extension which is provided in the order confirmation email. Please note license keys are site URL specific. If you require license keys for dev/staging sites then please email us at . [![image (2).png](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/scaled-1680-/6jQimage-2.png)](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/6jQimage-2.png) ### Configuration Settings for Lazy Loading [](#bkmrk--4) Go to **Admin > Stores > Configuration > Scommerce Configuration > Lazy Loading** #### General Settings [](#bkmrk--5) - **Enabled -** Select "Yes" or "No" to enable or disable the module. - **Loading Icon –** Show a preview image before the real image loads. - **Skip Images Count by page category –** Enter a valid image count to skip the images from lazy load. Based on the count this option will decide how many images to load without lazy loading. - **Ignore Images that Contain –** Provide a part of an image tag content into the field to exclude the image from the lazy load. - **Exclude Pages –** Select the page(s) from multi-select options to exclude from the lazy load. - **Lazy loading for product only on category page –** Select "Yes" to apply lazy load on product images only on category page. [![image.png](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/scaled-1680-/yaPimage.png)](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/yaPimage.png) [![image (1).png](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/scaled-1680-/cvvimage-1.png)](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/cvvimage-1.png) ### Front-end Screenshots [](#bkmrk--8) - **Lazy Loading on the Homepage –** To implement lazy loading on the homepage, enable the module from **Admin > Stores > Configuration > Lazy Loading- Enable "Yes".** **[![image.jpg](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/scaled-1680-/aL6image.jpg)](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/aL6image.jpg)** - **Home Page Excluded from Lazy Loading –** You can exclude homepage images from lazy loading by selecting option "Home Page" from **Admin > Stores > Configuration > Lazy Loading > Exclude Pages.** **[![image (2).jpg](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/scaled-1680-/B6Vimage-2.jpg)](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/B6Vimage-2.jpg)** - **Lazy Loading on the Category Page –** To implement lazy loading on the category page, enable the module from **Admin > Stores > Configuration > Lazy Loading - Enable "Yes"**. [![image (3).jpg](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/scaled-1680-/NOcimage-3.jpg)](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/NOcimage-3.jpg) - **Lazy Loading on the Search Page –** You can implement lazy loading on search page from **Admin > Stores > Configuration > Lazy Loading - Enable "Yes"**. [![image (4).jpg](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/scaled-1680-/FR2image-4.jpg)](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/FR2image-4.jpg) - **Lazy Loading on the Cart Page –** You can implement lazy loading on the cart page by enabling the module from **Admin > Stores > Configuration > Lazy Loading- Enable "Yes".** **[![image (5).jpg](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/scaled-1680-/L5Bimage-5.jpg)](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/L5Bimage-5.jpg)** If you have a question related to this extension please check out our [**FAQ section**](https://www.scommerce-mage.com/magento-2-lazy-load-image-extension.html#customfaq) first. If you can't find the answer you are looking for then please contact [**support@scommerce-mage.com**](mailto:core@scommerce-mage.com).