<img>Baseline · Widely available
The <img> element adds an image into the document.
Supported in all major browsers for at least 30 months — safe to use without fallbacks. Baseline since Jul 29, 2015. Widely available since Jan 29, 2018.
Browser support
DesktopChrome
1+Supportedsince Dec 11, 2008
Current: 155Edge
12+Supportedsince Jul 29, 2015
Current: 154Firefox
1+Supportedsince Nov 9, 2004
Current: 157Safari
1+Supportedsince Jun 23, 2003
Current: 27MobileChrome Android
18+Supportedsince Jun 27, 2012
Current: 155Firefox Android
4+Supportedsince Mar 29, 2011
Current: 157Safari iOS
1+Supportedsince Jun 29, 2007
Current: 27How to use
This feature is Baseline widely available — use it freely, no fallback needed.
Example
Full syntax and examples are on MDN: HTMLImageElement.
Feature detection
JS · check before using
const el = document.createElement("img");
if (!(el instanceof HTMLUnknownElement)) {
// <img> is supported
}Specification
Sub-features
Support for each part of the feature (21). The overall table above shows when the whole feature works.
| Sub-feature | Chrome | Edge | Firefox | Safari | Chrome Android | Firefox Android | Safari iOS |
|---|---|---|---|---|---|---|---|
| HTMLImageElement | 1 | 12 | 1 | 1 | 18 | 4 | 1 |
| HTMLImageElement.Image | 1 | 12 | 1 | 1 | 18 | 4 | 1 |
| HTMLImageElement.alt | 1 | 12 | 1 | 3 | 18 | 4 | 1 |
| HTMLImageElement.complete | 1 | 12 | 1 | 3 | 18 | 4 | 1 |
| HTMLImageElement.crossOrigin | 13 | 12 | 8 | 6 | 18 | 8 | 6 |
| HTMLImageElement.decode | 64 | 79 | 68 | 11.1 | 64 | 68 | 11.3 |
| HTMLImageElement.decoding | 65 | 79 | 63 | 11.1 | 65 | 63 | 11.3 |
| HTMLImageElement.height | 1 | 12 | 1 | 3 | 18 | 4 | 1 |
| HTMLImageElement.naturalHeight | 1 | 12 | 1 | 3 | 18 | 4 | 1 |
| HTMLImageElement.naturalWidth | 1 | 12 | 1 | 3 | 18 | 4 | 1 |
| HTMLImageElement.src | 1 | 12 | 1 | 3 | 18 | 4 | 1 |
| HTMLImageElement.width | 1 | 12 | 1 | 3 | 18 | 4 | 1 |
| HTMLImageElement.x | 1 | 12 | 14 | 3 | 18 | 14 | 1 |
| HTMLImageElement.y | 1 | 12 | 14 | 3 | 18 | 14 | 1 |
| img | 1 | 12 | 1 | 1 | 18 | 4 | 1 |
| img.alt | 1 | 12 | 1 | 3 | 18 | 4 | 2 |
| img.crossorigin | 13 | 12 | 8 | 6 | 18 | 8 | 6 |
| img.decoding | 65 | 79 | 63 | 11.1 | 65 | 63 | 11.3 |
| img.height | 1 | 12 | 1 | 3 | 18 | 4 | 2 |
| img.src | 1 | 12 | 1 | 1 | 18 | 4 | 1 |
Show 1 more
| Sub-feature | Chrome | Edge | Firefox | Safari | Chrome Android | Firefox Android | Safari iOS |
|---|---|---|---|---|---|---|---|
| img.width | 1 | 12 | 1 | 3 | 18 | 4 | 2 |