HTML <img> id Attribute

The id attribute on an <img> tag assigns an identifier to the image element. The identifier must be unique across the page.

Example

#

An id attribute on an <img> element.

Van Gogh, Self-portrait
<img id="image-vangogh"
     src="/img/html/vangogh.jpg"
     alt="Van Gogh, Self-portrait">

Using id

The id attribute assigns an identifier to the <img> element.

The identifier must be unique across the page.

The id allows programmatic access to the <img> element.

Tip:  id is a global attribute that can be applied to any HTML element.


Syntax

<img id="identifier" />

Values

#

Value Description
identifier A unique alphanumeric string. The id value must begin with a letter ([aside-Zaside-z]) and may be followed by any number of letters, digits ([0-9]), hyphens (-), underscores (_), colons (:), and periods (.).

More Examples

An <img> tag with a unique id.
Clicking the button displays the image url.

Van Gogh, Poppies

<img id="myimg"
     src="/img/html/poppies.jpg"
     alt="Van Gogh, Poppies">
  
<br/><br/>
<button onclick="show();">Show image src</button>

<script>
  let show = () => {
    let img = document.getElementById("myimg");
    alert("Src = " + img.src);
  }
</script>

Code explanation

The id attribute assigns a unique identifier for the <img> element.

Clicking the button calls JavaScript which locates the <img> using the id.

Finally, the src value of the <img> is displayed in an alert box.


Browser support

Here is when id support started for each browser:

Chrome
1.0 Sep 2008
Firefox
1.0 Sep 2002
IE/Edge
1.0 Aug 1995
Opera
1.0 Jan 2006
Safari
1.0 Jan 2003

You may also like

 Back to <img>
Guides