Buttons with no accessible 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
Icon-only or empty buttons with no aria-label are unusable for screen-reader users.
Why it matters
A button that contains only an icon, or nothing at all, is announced by screen readers as just "button", so the user has no idea what pressing it does. Close, delete, and menu buttons are the usual offenders, which are exactly the actions you do not want triggered blindly. Voice-control users are also stuck, since there is no name to speak.
How to fix it
Give every icon-only button an aria-label describing the action ("Close dialog", "Open menu", "Delete item"), or add a visually hidden text span inside the button using an sr-only utility class. Name the action, not the icon ("Search", not "Magnifying glass"). If a flagged button is genuinely empty and does nothing, remove it.
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