Accompanying Files
Observation Details

The HTML image element must always use have alt attribute present. Either

  • null alt attribute for purely decorative or

  • non-null alt attribute for informative/functional images.

Image elements missing alt attribute:

  • Main stage image embedded as background image

Remediation Notes

As background images cannot use alt attributes another method to display text alternative must be used. This can be done with properly visually (display: none will still fail this criterion) hidden text at the same position in DOM order.


Ideally, embed image with HTML image element instead of as background image.

Ensure, all HTML image elements properly set the alt attribute. Depending on the purpose of the image, choose whether to declare an image decorative, informative, or functional. For more guidance in choosing, refer to the W3C Alt-decision tree.

If the image is

  • purely decorative, set a null alt attribute as follows: <img alt="" />

  • not purely decorative, the alt attribute must not be null