Will It Vibe logoWill It Vibe?
A11Y-021Medium severity-8 points

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

Related Documentation, UX & Accessibility checks