aria-labelledby/aria-describedby references a missing id
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
aria-labelledby and aria-describedby point at another element by id to borrow its text as the accessible name or description; when that id does not exist in the file, assistive technology has nothing to read and silently falls back to no name/description at all, with no visible sign anything is wrong. Fix the referenced id, or add the missing element. Both attributes accept a space-separated list of ids, and each one is checked individually.
Why it matters
aria-labelledby and aria-describedby work by pointing at another element's id and reusing its text as the accessible name or description; when that id does not exist, assistive technology silently gets nothing; there is no visible sign in the UI that anything is broken, since sighted users never notice a missing accessible description.
How to fix it
Point the attribute at the correct, currently-existing id, or add the missing element back if it was removed by mistake. Since both attributes accept a space-separated list of ids, fix each missing one individually if only some of a multi-id reference are broken.
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