srcset requires providing multiple resized versions of every image, and with Cloudflare’s image resizing it’s easy.
There are two different ways to use
For an image with a fixed size in terms of CSS pixels, but adapting to high-DPI screens (also known as Retina displays). These images take the same amount of space on the page regardless of screen size, but are sharper on high-resolution displays. This is appropriate for icons, thumbnails, and most images on pages with fixed-width layouts.
Responsive images that stretch to fill a certain percentage of the screen (usually full width). This is best for "hero" images and pages with fluid layouts, including pages using media queries to adapt to various screen sizes.
srcset for high-DPI displays
We’re going to need two versions of every image. One for
1x density suitable for typical desktop displays (such as HD/1080p monitors, low-end laptops) and one for
2x high-density displays used by almost all mobile phones, high-end laptops and "4K" desktop displays. Some mobile phones have very high-DPI displays and could use even a
3x resolution. However, while jump from
2x is a clear improvement, there are diminishing returns from increasing the resolution further. The difference between
3x is visually insignificant, but
3x files are two times larger than
Assuming we have an image
assets folder, and we want to display it at size of
<img src="/cdn-cgi/image/fit=contain,width=960/assets/product.jpg" srcset="/cdn-cgi/image/fit=contain,width=1920/assets/product.jpg 2x">
src attribute is for images with the usual "1x" density.
/cdn-cgi/image/ is a special path for resizing images. Followed by
width=960 that resizes the image to have width of 960 pixels. Followed by
/assets/product.jpg which is a URL to the source image on the server.
srcset attribute adds another, high-DPI image. The browser will automatically select between the images in the
srcset. In this case we specify
width=1920 (2×960) and add
2x at the end, which informs the browser that it’s a double-density image. It will be displayed at the same size as a 960-pixel image, but doubled number of pixels will make it look twice as sharp on high-DPI displays.
Note that it doesn’t make sense to scale images up for use in
srcset. That would only increase file sizes without improving visual quality. The source images you use with
srcset must have high resolution, so that they’re only scaled down for "1x" displays and displayed as-is or also scaled down for "2x" displays.
srcset for responsive images
When you want to display an image that takes a certain percentage of the window or screen width, the image should have dimensions that are appropriate for visitor’s screen size. Screen sizes vary a lot, typically from 320 pixels to 3840 pixels, so there isn’t a single image size that fits all. With
<img srcset sizes> you can offer browser several possible sizes and let the browser choose the most appropriate size automatically.
By default browser assumes the image will be stretched to the full width of the screen, and will pick a size that is closest to visitor’s screen size. In the
src attribute pick any size that’s good as a fallback for older browsers that don’t understand
<img width="100%" srcset=" /cdn-cgi/image/fit=contain,width=320/assets/hero.jpg 320w, /cdn-cgi/image/fit=contain,width=640/assets/hero.jpg 640w, /cdn-cgi/image/fit=contain,width=960/assets/hero.jpg 960w, /cdn-cgi/image/fit=contain,width=1280/assets/hero.jpg 1280w, /cdn-cgi/image/fit=contain,width=2560/assets/hero.jpg 2560w, " src="/cdn-cgi/image/width=960/assets/hero.jpg">
In the previous case the number followed by
x described screen density. In this case the number followed by
w describes the image size. There’s no need to specify screen density here (
2x, etc.), because browser automatically takes it into account and picks a higher-resolution image when necessary.
If the image isn’t displayed at full width of the screen (or browser window): If it’s displayed at full width of a fixed-width column, use the first technique that uses one specific image size. If it takes a specific percentage of the screen, or stretches to full width only sometimes (using CSS media queries), then add
sizes attribute as described below.
If the image takes 50% of the screen (or window) width:
<img style="width: 50vw" srcset=" …same as before… " sizes="50vw">
vw unit is a percentage of viewport (screen or window) width. If the image could have a different size depending on media queries or other CSS properties such as
max-width, then specify all the conditions in the
<img style="max-width: 640px" srcset=" /cdn-cgi/image/fit=contain,width=320/assets/hero.jpg 320w, /cdn-cgi/image/fit=contain,width=480/assets/hero.jpg 480w, /cdn-cgi/image/fit=contain,width=640/assets/hero.jpg 640w, /cdn-cgi/image/fit=contain,width=1280/assets/hero.jpg 1280w, " sizes="(max-width: 640px) 100vw, 640px">
In this example
sizes says that for screens smaller than 640 pixels the image is displayed at full viewport width, and on all larger screens stays at 640px. Note that one of the options in
srcset is 1280 pixels large, because an image displayed at 640 CSS pixels may need twice as many image pixels on a high-dpi ("2x") display.
What about other formats?
srcset is useful for pixel-based formats such as PNG, JPEG and WebP. It is unnecessary for vector-based SVG images.
If you want to use WebP images, but don’t need resizing, you have two options:
You can enable Polish feature with automatic WebP conversion. This will convert all images on the site, or
Change specific image paths on the site to start with