Skip to main content
All rules

A11Y-009

Duplicate id breaks a label or description

MediumDefault severity · Accessibility · Accessibility (WCAG 2.2 AA)

Last reviewed

What it checks

ids used by label[for], aria-labelledby or aria-describedby that appear more than once in the page.

Why it matters

Assistive technology follows only one of the duplicates, so a field or control is announced with the wrong label or none.

Recommended fix

Make every referenced id unique.

How to verify

Run an accessibility checker (axe) and confirm no duplicate-id-aria issues.

Example fix prompt

Generic prompt (your report adds the evidence)
Please fix this production issue in my app.

Issue A11Y-009: Duplicate id breaks a label or description
Site: https://your-app.example

First confirm the issue in the code or live config. If it is not present, say so and change nothing.
Task: Make the ids in the evidence unique on the page (generate them with useId() or a prefix per component) and update the matching for / aria-labelledby / aria-describedby references.

Constraints: make the smallest change that fixes this, keep the current design and behaviour, never paste secret values into code or chat, and tell me which files you changed.
Done when: Run an accessibility checker (axe) and confirm no duplicate-id-aria issues.

References