HTML imagesizes Attribute: Reference and Examples

The imagesizes attribute is a small instruction attached to an HTML element. Its job is to responsive image size conditions for preload. It is easier to remember when you can see it in a real piece of markup.

What imagesizes is used for

Responsive image size conditions for preload. The attribute appears inside an element’s opening tag. Depending on its definition, it may take a specific string, a number, an enumerated keyword, or be a boolean attribute.

The example below uses it in a preload context. Other elements may support it too, or may give the same attribute a different meaning.

Example you can try

<head>
    <link rel="preload" as="image" href="hero-960.jpg" imagesrcset="hero-480.jpg 480w, hero-960.jpg 960w" imagesizes="100vw">
</head>

How the example works

Look for imagesizes in the snippet. Here the example shows the value 100vw. This is a concrete input the browser can interpret; it is not just text shown to the reader.

Use together with imagesrcset and rel="preload" with an image resource; the size describes the intended rendered image.

Values and important behavior

Use the value format shown by the HTML definition. Do not assume that a value accepted in one attribute also works in another. When a browser ignores an invalid value, inspect the element and correct the markup.

This detail matters most when the page receives user input, navigates to another document, or loads an external resource. In those cases, check the browser behavior and any server-side requirements separately.

Small practice task

Copy the code and change imagesizes to another sensible value, or remove it entirely if it is optional. Test the difference in the browser and inspect any submitted value or network request.

Common Beginner Mistakes

• Use together with imagesrcset and rel="preload" with an image resource; the size describes the intended rendered image.
• Using imagesizes on an element that does not support it.
• Believing that an HTML hint or client-side check replaces real server validation or a security policy.

Key Takeaways

• imagesizes is used to responsive image size conditions for preload.
• Use together with imagesrcset and rel="preload" with an image resource; the size describes the intended rendered image.
• Choose valid values and test the result instead of guessing what the browser will do.