Alt text decision tree

This decision tree describes how to use the alt attribute of the <img> element in different situations. The decision tree does not cover all cases. For example, it does not cover MathML, groups of images, image maps and other alt text approaches for functional and complex images (e.g. aria-label, aria-labelledby, figcaption, etc). For detailed information on the provision of text alternatives, refer to the sections above.

An alt attribute decision tree. Text description follows.
Text description of the alt decision tree
  1. What is the purpose of the image?
    • If decorative: Use alt="" or use CSS
    • If informative: Go to step 2
  2. Does it add new info?
    • If no, the image is redundant: Use alt="" or use CSS
    • If yes: Go to step 3
  3. What kind of info does it add?
    • If actionable: Use alt="[label for link]"
    • If emotional or simple: Use alt="[description]"
    • If complex: Use alt="[short description]" + location of the long description

Related WCAG resources

Related WCAG resources

Success criteria

Techniques

Failures

Back to top