no-alt
Rule Severity : Serious
Description
All non-decorative images must include a meaningful alt
attribute. The alt
text conveys the image’s purpose to users who rely on assistive technologies.
Users with visual impairments depend on screen readers to interpret images. Missing alt
text results in a poor user experience and makes visual content inaccessible. Providing the alt
text ensures equal access to information.
Examples
The following example lacks alt
text, making it inaccessible to users who rely on screen readers.
The following corrected example includes the alt
text, providing users with essential information and context.
How to fix?
- Ensure the
alt
text accurately describes the purpose of the image. - Avoid vague or misleading
alt
descriptions. - If the image is purely decorative, use
alt=""
orrole="presentation"
to hide it from screen readers.
References
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!