Images missing alt text
Part of Documentation, UX & Accessibility, which counts for 15% of the overall score. When this check fires it deducts 8 points from that category, once per scan, no matter how many places it turns up.
What it detects
Images without an alt attribute are invisible to screen readers.
Why it matters
An <img> without an alt attribute is a dead spot for screen-reader users: the reader either says nothing useful or reads out the file name, which is worse. Alt text is also what renders when an image fails to load on a bad connection, and it is how image search understands your content. This is one of the most common and most fixable accessibility failures.
How to fix it
Add an alt attribute to every image. For informative images, write a short description of what the image shows or does ("Line chart of monthly signups", "Company logo"), without starting with "image of". For purely decorative images, use an explicit empty value, alt="", so screen readers skip them instead of announcing the filename. In JSX the same rules apply, and eslint-plugin-jsx-a11y can enforce them going forward.
The paid report includes a ready-to-paste prompt for your AI coding agent for every check it finds, pointed at the exact findings from your scan. See pricing
Does your repo trip this check?
Paste a GitHub URL or drop a project folder. Scans run in your browser and take seconds.
Scan your repo