News and More | MGH IHP

Ways to Give | MGH IHP

Giving | MGH IHP

Faculty & Staff | MGH IHP

Academics | MGH IHP

Apply | MGH IHP

IHP Directory | MGH IHP

Page not found | MGH IHP

Home | MGH IHP

IHP Experience | MGH IHP

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

June 2025

May 2025

MGH Institute of Health Professions

Title / URL	Issues
News and More \| MGH IHPwww.mghihp.edu/news-and-more	5
Ways to Give \| MGH IHPwww.mghihp.edu/giving/ways-to-give	3
Giving \| MGH IHPwww.mghihp.edu/giving	3
Faculty & Staff \| MGH IHPwww.mghihp.edu/faculty-staff	3
Academics \| MGH IHPwww.mghihp.edu/academics	1
Apply \| MGH IHPwww.mghihp.edu/admissions/apply	1
IHP Directory \| MGH IHPwww.mghihp.edu/ihp-directory	1
Page not found \| MGH IHPwww.mghihp.edu/invented-url-for-404-page	1
Home \| MGH IHPwww.mghihp.edu/	1
IHP Experience \| MGH IHPwww.mghihp.edu/ihp-experience	1

Fix missing ARIA label IDs

MGH Institute of Health Professions

Where this issue has occurred