Back to Content

HTMLImageElement: alt property

files/en-us/web/api/htmlimageelement/alt/index.md

latest993 B
Original Source

{{APIRef("HTML DOM")}}

The alt property of the {{domxref("HTMLImageElement")}} interface provides fallback (alternate) text to display when the image specified by the {{HTMLElement("img")}} element is not displayed, whether because of an error, because the user has disabled the loading of images, or because the image hasn't finished loading yet. It reflects the `` element's alt content attribute.

There are important accessibility implications of providing appropriate alt text, and the requirements may differ based on the purpose of the image. See the HTML `` reference for more information.

Value

A string.

Examples

Setting the alt attribute

js
const img = new Image();
img.src = "example.png";
img.alt = "An example picture";

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}