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

July 2025

June 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