Fastly image optimization (Fastly IO) provides real-time image manipulation and optimization to speed up image delivery and simplify maintenance of image source sets for responsive web applications. Once configured Fastly IO provides the following image optimization features:
Before you enable and configure the Fastly IO option, you must set up your Fastly service and configure Origin shielding.
Based on your configuration settings, the Fastly Image Optimization (Fastly IO) snippet inserts the VCL code to perform the image optimization that speeds up product image delivery in the storefront. There are three steps to configure the Fastly IO: Enable, Configure, and Verify.
Enable Fastly image optimization (Fastly IO) from the Admin panel by uploading the Fastly IO VCL snippet. The snippet provides the Fastly configuration instructions to process all images through image optimizers, using default configurations.
To enable Fastly IO:
Log in to your local Admin panel as an administrator.
Select Stores > Settings > Configuration > Advanced > System.
In the right pane, expand Full Page Cache.
Select Fastly Configuration > Image Optimization to specify the configuration settings.
In the Fastly IO snippet field, select Enable/Disable.
Upload the Fastly IO snippet:
Review and update the default IO configuration settings for image optimization as needed. For example, you might want to change WebP and JPEG quality levels for lossy formats, or change the format for serving JPEG images to Progressive or Baseline. Also, you can use Fastly IO for more granular image optimization features, such as:
To update Fastly IO:
On the Fastly Configuration page in the Default IO config options field, select Configure.
Review and update the Fastly IO configuration settings on the Image optimization default config options page:
Auto WebP?—leave the default setting (
Yes) to convert images to the WebP format in browsers that support it. If you change the setting to No, Fastly uses the image file type instead of converting the image to WebP format.
Default WebP (lossy) quality—leave the default setting (
85) or type the compression level for lossy file-formatted images. You can specify any whole number from 1 to 100.
Default JPEG format controls — leave the default setting (
Auto), or select the JPEG type to use when serving an image. If the value is set to the Auto, Fastly delivers images with the output type matching the input type. Select Baseline to display images line by line starting from top left and going to the bottom right. Select Progressive to display a blurry image that becomes clear as it loads.
Default JPEG quality—leave the default setting (
85) or type the compression level for quality of lossy file formats. Specify any whole number from 1 to 100.
Allow upscaling?—leave default setting (
No), or select
Yes to return images larger than the original source file so they can fit the requested dimensions.
Resize filter—leave the default setting (
Lancsoz3), or select an alternative. This setting specifies the filter used to deliver a resized image. Depending on the filter selected, the resized image can have a higher or lower number of pixels.
Lanczos3(default)—Delivers the best quality image. It increases the ability to detect edges and linear features within an image and uses sinc resampling to provide the best possible reconstruction.
Lanczos2—Uses same filter as
Lancsoz3but with a less accurate approximation of the sinc resampling function.
Bicubic—Has a natural sharpening effect when making an image smaller.
Bilinear—Has a natural smoothing effect when making an image larger.
Nearest—Has a natural pixelation effect when resizing pixel art.
After you specify the IO configuration settings for the Fastly service, select Cancel to return to the Fastly configuration settings.
In the Image Optimization configuration Enable deep image optimization field, select Yes to turn on deep image optimization.
Deep image optimization is off by default. When this feature is enabled, the built-in resizing feature in Adobe Commerce is turned off and resizing work is offloaded to the Fastly IO service. Image optimization only applies to product images. CMS images are not resized. See the Fastly documentation.
After you enable deep image optimization, enable the adaptive pixel ratios feature to generate images optimized for use in responsive websites.
Select Save Configuration.
By default the Fastly IO service forces conversion of lossless formats such as PNG, BMP, or WEBP into JPEG/WEBP format.
The advantage of forcing lossy conversion is that smaller images are served.
For example, by using JPEG or WEBp format instead of PNG, the size may be reduced by 60 to 70 percent depending on the quality level specified in the Fastly IO configuration.
Depending on the quality level selected for image optimization, you might perceive visual differences in images. For example, Alpha channel/transparencies are stripped out and replaced with a white background, unless you use Deep image optimization which uses the background color of your theme.
If you turn off lossy conversion (
WebP Auto? = No), Fastly IO only changes JPEG images to WEBP format for compatible browsers. No other image types are changed. For example, if the original image is PNG the output from the Fastly IO service is PNG.
Deep image optimization is off by default. Enabling this option turns off the built-in Adobe Commerce resizing and offloads it completely to the Fastly IO service.
This feature only resizes product images. CMS images are not resized.
Enabling deep image optimization adds a background color definition to every image as defined in your theme. As a result, WebP images are switched from WebP lossless to WebP lossy. One of the major differences between lossless and lossy is that lossy drops the alpha channel from PNG images, which delivers much smaller images. However, images with transparencies can look odd on product and campaign pages that use a different background.
For example, the following code represents the original source for an image from the Luma theme:
<img class="product-image-photo" src="https://mymagentosite/pub/media/catalog/product/cache/f073062f50e48eb0f0998593e568d857/m/b/mb02-gray-0.jpg" width="240" height="300" alt="Fusion Backpack"/>
When the Fastly IO Deep image optimization feature is enabled, the original source code for the image is rewritten as shown in the following example:
<img class="product-image-photo" src="https://mymagentosite/pub/media/catalog/product/m/b/mb02-gray-0.jpg?width=240&height=300&quality=80&bg-color=255,255,255&fit=bounds" width="240" height="300" alt="Fusion Backpack"/>
The Adaptive pixel ratios feature is useful to optimize images for Progressive web applications. It allows you to deliver multiple image sizes and resolutions from one image source file by adding a
srcset for each product image.
When the Adaptive pixel ratios feature is enabled, the Fastly IO service delivers a fixed-width image that can adapt to varying
For example, the service modifies the product image definition as shown in the following example:
<img class="product-image-photo" srcset="https://mymagentosite/pub/media/catalog/product/m/b/mb02-gray-0.jpg?width=240&height=300&quality=80&bg-color=255,255,255&fit=bounds&dpr=2 2x, https://mymagentosite/pub/media/catalog/product/m/b/mb02-gray-0.jpg?width=240&height=300&quality=80&bg-color=255,255,255&fit=bounds&dpr=3 3x" src="https://mymagentosite/pub/media/catalog/product/m/b/mb02-gray-0.jpg?width=240&height=300&quality=80&bg-color=255,255,255&fit=bounds" width="240" height="300" alt="Fusion Backpack"/>
After you enable and configure Fastly IO, validate your configuration by performing web page speed tests with and without Fastly IO enabled. Also, review the images in your store to check image size and appearance for issues.