The Reading Room | The National Archives of Ireland

Search | The National Archives of Ireland

Group Visits | The National Archives of Ireland

Search the Census | The National Archives of Ireland

Government Services | The National Archives of Ireland

Filming Requests | The National Archives of Ireland

Governing Legislation | The National Archives of Ireland

Readers Ticket | The National Archives of Ireland

News and Events | The National Archives of Ireland

Reports and Policies | The National Archives of Ireland

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

September 2025

August 2025

National Archives of Ireland

Title / URL	Issues
The Reading Room \| The National Archives of Irelandnationalarchives.ie/plan-a-visit/the-reading-room/	1
Search \| The National Archives of Irelandnationalarchives.ie/search/	1
Group Visits \| The National Archives of Irelandnationalarchives.ie/plan-a-visit/group-visits/	1
Search the Census \| The National Archives of Irelandnationalarchives.ie/collections/search-the-census/	1
Government Services \| The National Archives of Irelandnationalarchives.ie/government-services/	1
Filming Requests \| The National Archives of Irelandnationalarchives.ie/plan-a-visit/filming-requests/	1
Governing Legislation \| The National Archives of Irelandnationalarchives.ie/about/governing-legislation/	1
Readers Ticket \| The National Archives of Irelandnationalarchives.ie/plan-a-visit/readers-ticket/	1
News and Events \| The National Archives of Irelandnationalarchives.ie/news-and-events/	1
Reports and Policies \| The National Archives of Irelandnationalarchives.ie/about/reports-and-policies/	1

Fix missing ARIA label IDs

National Archives of Ireland

Where this issue has occurred