Ensure the information a user needs to receive from an image is provided in text form.
- Provide alternative text in the
altattribute if the image is not described in the surrounding text. [WCAG 1.1.1]
- H37: Using alt attributes on img elements
- H36: Using alt attributes on images used as submit buttons
- G94: Providing short text alternative for non-text content that serves the same purpose and presents the same information as the non-text content
- G100: Providing a short text alternative which is the accepted name or a descriptive name of the non-text content
- Provide an extended description for complex images. [WCAG 1.1.1]
- G73: Providing a long description in another location with a link to it that is immediately adjacent to the non-text content
- G74: Providing a long description in text near the non-text content, with a reference to the location of the long description in the short description
- G92: Providing long description for non-text content that serves the same purpose and presents the same information
- Ensure that decorative images have an empty alt attribute (
alt=""). [WCAG 1.1.1]
- Ensure that any animated graphics do not present the risk of seizures. [WCAG 2.3.1 and WCAG 2.3.2]
Images that are central to the understanding of a publication must always include a text alternative in
alt attribute. In the case of complex images, a detailed description should also be
If the image is purely decorative, the
alt attribute should be left empty. For additional
insurance that decorative images will not be announced, the ARIA
role attribute with the
presentation can be attached.
details element is now a part of HTML 5.1, it is not available for use
in content that conforms to EPUB 3.0.1 or earlier versions of the standard. Only EPUB 3.1 and its
successors allow this element.
- HTML5 — The
Frequently Asked Questions
- Should I put
It is best practice to use one of these roles if an image is purely decorative (
noneis preferred as of ARIA 1.1), but it is not required for conformance with WCAG.
Do not use these roles in place of an empty
altattribute. Not only is this not technically conforming HTML (an
altattribute can only be omitted in very select cases), but it may not work with older assistive technologies.