Homepage | The Pensions Ombudsman

Making a complaint | The Pensions Ombudsman

What's involved? | The Pensions Ombudsman

What we do | The Pensions Ombudsman

Submit a complaint | The Pensions Ombudsman

Can I complain? | The Pensions Ombudsman

Check we can help with your complaint | The Pensions Ombudsman

First time visit: View without clicking anything

When specifying accessible names via `aria-labelledby`, ensure that the 
label elements exist.

## Explanation

Accessible names are required for many parts of a page, including form controls.
One way to accomplish this is to use `aria-labelledby` to specify the ID or IDs of 
other elements which contain a label. For example:

```html
<h2 id="dialog-labell">Important message!</h2>
<dialog aria-labelledby="dialog-label">
```

In this example, the `aria-labelledby` for the `<dialog>` points to an ID of `dialog-label`,
which doesn't exist. The heading it refers to instead has an ID of `dialog-labell`, presumably 
a typo.

## Why this matters

It isn't usually clear when an accessible name is broken, even during user testing.

This check helps to identify where an element clearly intended to have a label, but
that label is missing.

When a label is broken, it may be impossible for a user of assistive technologies
to understand what that element does.

missing-aria-labelled-by

March 2025

February 2025

Pensions Ombudsman

Title / URL	Issues
Homepage \| The Pensions Ombudsmanwww.pensions-ombudsman.org.uk/	1
Making a complaint \| The Pensions Ombudsmanwww.pensions-ombudsman.org.uk/making-complaint	1
What's involved? \| The Pensions Ombudsmanwww.pensions-ombudsman.org.uk/whats-involved	1
What we do \| The Pensions Ombudsmanwww.pensions-ombudsman.org.uk/what-we-do	1
Submit a complaint \| The Pensions Ombudsmanwww.pensions-ombudsman.org.uk/submit-complaint	1
Can I complain? \| The Pensions Ombudsmanwww.pensions-ombudsman.org.uk/can-i-complain	1
Check we can help with your complaint \| The Pensions Ombudsmanwww.pensions-ombudsman.org.uk/check-we-can-help-your-complaint	1
First time visit: View without clicking anythingwww.pensions-ombudsman.org.uk/	1

Fix missing ARIA label IDs

Pensions Ombudsman

Where this issue has occurred