Responsive images

Responsive images are automatically enabled to ensure your images load quickly on any device.

We’re transitioning to a new UI, and are in the process of updating our Webflow University content.
Webflow-created variants of an uploaded image. There is an original image followed by variants with sizes of 2000px, 1600px, 1080px, 800px, and 500px.

When you upload images to your site, Webflow creates variants of your uploaded images to make sure they’re responsive and load quickly on any device. This can help your mobile pages load up to 10 times faster.

Making an image responsive means that your browser serves a different sized version of that image based on the size of the image on your page and the screen resolution (by adding srcset and sizes attributes to your <img> elements). To give the browser access to different sized versions of images, Webflow creates a set of variants for each image upon upload, then encodes instructions for your browser to know when to serve each variant.

Important: If your original images are compressed enough, Webflow uses your original images.

How to manually generate responsive images across a site

Webflow measures your images and generates responsive variants as you work on a site page. But you may make changes that affect images on other pages (e.g., updating a Component or class). To ensure that all your images remain responsive, you can either visit the affected page, or use the shortcut Command + Shift + I (on Mac) or Control + Shift + I (on Windows), and the Designer will scan and re-measure all your pages for you.

How to generate responsive images for sites built before September 2016

If you created your site before September 14th, 2016, you’ll need to walk through a quick process to generate responsive images on your site. The next time you open the Designer, you’ll see a modal asking you to start the migration process. 

This process can take a few minutes, depending on the size of your site. If you’d rather do this later, you can start the process anytime from the Assets panel or by using the shortcut Command + Shift + I (on Mac) or Control + Shift + I (on Windows).

How to disable responsive images

To disable this feature for a specific image (e.g., if you need to force the browser to use the original image size):

  1. Select the image on the canvas
  2. Open Settings panel > Image settings
  3. Uncheck the Image is responsive checkbox

How to manage responsive images with interactions

Webflow creates responsive images from their normal states — not their hover states or interactions that may change the size of the image. After adding hover state styles or interactions, it’s best practice to go over your site and make sure everything looks okay before publishing.

In some cases, you may need to add additional styling to override the sizes attributes effect on image element dimensions. For example, you may need to set the image’s width to 100% to fill its container. 

FAQ

What are the supported image types?

This feature generates responsive variants for all inline JPGs, PNGs, and WebP images, except those added via rich text elements. It also doesn’t apply to background images. We recommend SVGs and PNGs for high detail or vector based images, since these have lossless compression.

How many variants are generated per image?

The number of variants Webflow generates depends on the image’s original size. If it’s larger than 3200px wide, Webflow will generate 7 variants: 3200px, 2600px, 2000px, 1600px, 1080px, 800px, and 500px.

What size images should I upload?

You can upload any image size you’d like, provided it is smaller than our 4MB limit. Your browser will serve whichever variant is best, based on device size and resolution. For example, if you upload a 4000px wide original image but it is only rendered at 300px width on mobile, your browser will serve the 500px Webflow-created variant.

Are responsive variants exported?

Yes, responsive images will have srcset and sizes attributes in the exported site, and the variants will be in the /images folder of the .zip file along with your original images.

Learn more about responsive images on the Webflow blog. For those who want to dive deeper into responsive image tech, Eric Portis’ article in A List Apart may also be helpful.

Table of contents

Continue learning

Hmm…we couldn’t find any results for “search query”. Try a different search term or check out our community forum.

Search the forumReset the filter
Load more

Filter

Reset
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Topics
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Back to top