Codectionary / Developer documentation / HTML

<img>

The <img> element embeds images into web pages. Images enhance visual communication and user engagement. The src attribute specifies the image source, while alt provides alternative text for accessibility and SEO. Images are inline-replaced elements, meaning they display in the flow of text but are replaced with the actual image content.

Syntax

<img src="path/to/image.jpg" alt="description">

Examples

Basic Image

A simple image with source and alternative text for accessibility.

<img src="https://via.placeholder.com/400x300" alt="Placeholder image" style="max-width: 100%; height: auto;">

Responsive Image

Creating responsive images that scale properly on different screen sizes.

<img src="https://via.placeholder.com/800x600" 
     alt="Responsive landscape" 
     style="width: 100%; max-width: 600px; height: auto; border-radius: 8px; box-shadow: 0 4px 6px rgba(0,0,0,0.1);">

Image with Caption

Combining image with figure and figcaption elements for proper semantic markup.

<figure style="margin: 0; text-align: center;">
  <img src="https://via.placeholder.com/500x300" 
       alt="Sample image with caption" 
       style="width: 100%; max-width: 500px; border-radius: 8px;">
  <figcaption style="margin-top: 10px; color: #666; font-style: italic;">This is a descriptive caption for the image above</figcaption>
</figure>

Image Gallery

Creating a simple image gallery using multiple images with consistent styling.

<div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(150px, 1fr)); gap: 15px;">
  <img src="https://via.placeholder.com/200" alt="Gallery image 1" style="width: 100%; border-radius: 8px; transition: transform 0.3s; cursor: pointer;" onmouseover="this.style.transform='scale(1.05)'" onmouseout="this.style.transform='scale(1)'">
  <img src="https://via.placeholder.com/200/FF6B6B" alt="Gallery image 2" style="width: 100%; border-radius: 8px; transition: transform 0.3s; cursor: pointer;" onmouseover="this.style.transform='scale(1.05)'" onmouseout="this.style.transform='scale(1)'">
  <img src="https://via.placeholder.com/200/4ECDC4" alt="Gallery image 3" style="width: 100%; border-radius: 8px; transition: transform 0.3s; cursor: pointer;" onmouseover="this.style.transform='scale(1.05)'" onmouseout="this.style.transform='scale(1)'">
</div>

Attributes

  • src (URL): Path to the image file (required)
  • alt (string): Alternative text description (required for accessibility)
  • width (number): Image width in pixels
  • height (number): Image height in pixels
  • loading (lazy | eager): Controls image loading behavior
  • srcset (string): Multiple image sources for responsive images

Best practices

  • Always include descriptive alt text that explains the image content and purpose
  • Use appropriate image formats: JPEG for photos, PNG for graphics with transparency, SVG for icons
  • Optimize images for web - compress large files without sacrificing quality
  • Set width and height to prevent layout shift during page load
  • Use lazy loading (loading="lazy") for images below the fold to improve performance
  • Consider using srcset for responsive images that adapt to different screen sizes

Browser compatibility

Support applies to the named feature, not every attribute or behaviour in this article. Versions refer to browsers, not operating systems.

<img>

Desktop

Chrome
Supported
From 1
Firefox
Supported
From 1
Safari
Supported
From 1
Edge
Supported
From 12
Opera
Supported
From 15

Mobile

Safari on iOS
Supported
From 1
Chrome for Android
Supported
From 18
Firefox for Android
Supported
From 4
Samsung Internet
Supported
From 1.0

MDN BCD record for this feature · MDN reference

Support history and limitations

Chrome

  • From 1
  • By 37 (possibly earlier) · Alternative name: image

Firefox

  • From 1
  • By 32 (possibly earlier) · Alternative name: image

Safari

  • From 1
  • From 5.1 · Alternative name: image

Edge

  • From 12
  • From 15 · Alternative name: image

Opera

  • From 15
  • By 24 (possibly earlier) · Alternative name: image

Safari on iOS

  • From 1
  • From 5 · Alternative name: image

Chrome for Android

  • From 18
  • By 37 (possibly earlier) · Alternative name: image

Firefox for Android

  • From 4
  • By 32 (possibly earlier) · Alternative name: image

Samsung Internet

  • From 1.0
  • By 3.0 (possibly earlier) · Alternative name: image
<img> src

Desktop

Chrome
Supported
From 1
Firefox
Supported
From 1
Safari
Supported
From 1
Edge
Supported
From 12
Opera
Supported
From 15

Mobile

Safari on iOS
Supported
From 1
Chrome for Android
Supported
From 18
Firefox for Android
Supported
From 4
Samsung Internet
Supported
From 1.0

MDN BCD record for this feature

Support history and limitations

Chrome

  • From 1

Firefox

  • From 1

Safari

  • From 1

Edge

  • From 12

Opera

  • From 15

Safari on iOS

  • From 1

Chrome for Android

  • From 18

Firefox for Android

  • From 4

Samsung Internet

  • From 1.0
<img> alt

Desktop

Chrome
Supported
From 1
Firefox
Supported
From 1
Safari
Supported
From 3
Edge
Supported
From 12
Opera
Supported
From 15

Mobile

Safari on iOS
Supported
From 2
Chrome for Android
Supported
From 18
Firefox for Android
Supported
From 4
Samsung Internet
Supported
From 1.0

MDN BCD record for this feature

Support history and limitations

Chrome

  • From 1

Firefox

  • From 1

Safari

  • From 3

Edge

  • From 12

Opera

  • From 15

Safari on iOS

  • From 2

Chrome for Android

  • From 18

Firefox for Android

  • From 4

Samsung Internet

  • From 1.0
<img> width

Desktop

Chrome
Supported
From 1
Firefox
Supported
From 1
Safari
Supported
From 3
Edge
Supported
From 12
Opera
Supported
From 15

Mobile

Safari on iOS
Supported
From 2
Chrome for Android
Supported
From 18
Firefox for Android
Supported
From 4
Samsung Internet
Supported
From 1.0

MDN BCD record for this feature

Support history and limitations

Chrome

  • From 1

Firefox

  • From 1

Safari

  • From 3

Edge

  • From 12

Opera

  • From 15

Safari on iOS

  • From 2

Chrome for Android

  • From 18

Firefox for Android

  • From 4

Samsung Internet

  • From 1.0
<img> height

Desktop

Chrome
Supported
From 1
Firefox
Supported
From 1
Safari
Supported
From 3
Edge
Supported
From 12
Opera
Supported
From 15

Mobile

Safari on iOS
Supported
From 2
Chrome for Android
Supported
From 18
Firefox for Android
Supported
From 4
Samsung Internet
Supported
From 1.0

MDN BCD record for this feature

Support history and limitations

Chrome

  • From 1

Firefox

  • From 1

Safari

  • From 3

Edge

  • From 12

Opera

  • From 15

Safari on iOS

  • From 2

Chrome for Android

  • From 18

Firefox for Android

  • From 4

Samsung Internet

  • From 1.0
<img> loading

Desktop

Chrome
Supported
From 77
Firefox
Supported
From 75
Safari
Supported
From 15.4
Edge
Supported
From 79
Opera
Supported
From 64

Mobile

Safari on iOS
Supported
From 15.4
Chrome for Android
Supported
From 77
Firefox for Android
Supported
From 79
Samsung Internet
Supported
From 12.0

MDN BCD record for this feature

Support history and limitations

Chrome

  • From 77

Firefox

  • From 75

Safari

  • From 15.4

Edge

  • From 79

Opera

  • From 64

Safari on iOS

  • From 15.4

Chrome for Android

  • From 77

Firefox for Android

  • From 79

Samsung Internet

  • From 12.0
<img> srcset

Desktop

Chrome
Supported
From 34
Firefox
Supported
From 38
Safari
Supported
From 8
Edge
Supported
From 12
Opera
Supported
From 21

Mobile

Safari on iOS
Supported
From 8
Chrome for Android
Supported
From 34
Firefox for Android
Supported
From 38
Samsung Internet
Supported
From 2.0

MDN BCD record for this feature

Support history and limitations

Chrome

  • From 34

Firefox

  • From 38

Safari

  • From 8

Edge

  • From 12

Opera

  • From 21

Safari on iOS

  • From 8

Chrome for Android

  • From 34

Firefox for Android

  • From 38

Samsung Internet

  • From 2.0
<img> sizes

Desktop

Chrome
Supported
From 38
Firefox
Supported
From 38
Safari
Supported
From 9.1
Edge
Supported
From 12
Opera
Supported
From 25

Mobile

Safari on iOS
Supported
From 9.3
Chrome for Android
Supported
From 38
Firefox for Android
Supported
From 38
Samsung Internet
Supported
From 3.0

MDN BCD record for this feature

Support history and limitations

Chrome

  • From 38

Firefox

  • From 38

Safari

  • From 9.1

Edge

  • From 12

Opera

  • From 25

Safari on iOS

  • From 9.3

Chrome for Android

  • From 38

Firefox for Android

  • From 38

Samsung Internet

  • From 3.0

MDN BCD 8.1.5 · Dataset built 2026-10-08 · Mapping reviewed 2026-10-21. These dates are not individual browser-test or claim-verification dates. Unknown means the data does not establish support.

HTML Living Standard

Specifications & further reading