HTMLImageElement: alt property

{{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

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

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}