Will It Vibe?Linked/button image has empty alt and no name on its parent
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
An <a> or <button> whose only content is an <img alt=""> (correctly empty, since the image is decorative) but that itself carries no aria-label gives the control zero accessible name: a screen reader announces "link" or "button" with nothing else, and the destination or action is a complete mystery. Either give the image real alt text describing where the link goes / what the button does, or keep alt="" and add an aria-label to the <a>/<button> itself.
Why it matters
A linked or clickable image with alt="" (correctly marking the image itself as decorative) but no aria-label on its wrapping <a>/<button> leaves the control with zero accessible name: a screen reader announces bare "link" or "button" with no way to tell where it goes or what it does. This is a common bug in logo-links and icon-buttons where the empty alt was applied correctly but the parent control was never given its own name.
How to fix it
Add aria-label to the <a>/<button> describing its destination or action ("Go to homepage", "Close dialog"), keeping the image's alt="" as-is since the image genuinely is decorative once the parent has its own name. Alternatively, give the image real, descriptive alt text and remove the empty alt, which also gives the control a name without touching the parent tag.
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