Sign up to our newsletter | Samaritans

How Samaritans helps in schools

Samaritans News | Samaritans Press Releases | News from Samaritans Charity

Accessibility | Samaritans | About Samaritans

How Samaritans can help in the workplace

Samaritans | Every life lost to suicide is a tragedy | Here to listen

Contact Us | Samaritans

Page not found | Samaritans

Campaigns

About Samaritans | Samaritans charity

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

May 2025

April 2025

Samaritans

Title / URL	Issues
Sign up to our newsletter \| Samaritanswww.samaritans.org/newsletter/	3
How Samaritans helps in schoolswww.samaritans.org/ireland/how-we-can-help/schools/	3
Samaritans News \| Samaritans Press Releases \| News from Samaritans Charitywww.samaritans.org/ireland/news/	3
Accessibility \| Samaritans \| About Samaritanswww.samaritans.org/ireland/accessibility/	3
How Samaritans can help in the workplacewww.samaritans.org/ireland/how-we-can-help/workplace/	3
Samaritans \| Every life lost to suicide is a tragedy \| Here to listenwww.samaritans.org/ireland/?currency=EUR	3
Contact Us \| Samaritanswww.samaritans.org/ireland/how-we-can-help/contact-samaritan/	3
Page not found \| Samaritanswww.samaritans.org/ireland/invented-url-for-404-page/	3
Campaignswww.samaritans.org/ireland/support-us/campaign/	3
About Samaritans \| Samaritans charitywww.samaritans.org/ireland/about-samaritans/	3

Fix missing ARIA label IDs

Samaritans

Where this issue has occurred