Getting Started | National Library of Ireland

Reader's Ticket | National Library of Ireland

NLI on the Flickr Commons | National Library of Ireland

Our work with the Collections | National Library of Ireland

Visit Safely | National Library of Ireland

eResources | National Library of Ireland

Opening Hours | National Library of Ireland

Getting Here | National Library of Ireland

Borrow a Banner Exhibition | National Library of Ireland

Accessibility | National Library of Ireland

Lists (e.g., `<ul>` or `<ol>`) should only contain list items (`<li>`) as a direct descendant 
to ensure that screen readers can accurately report the amount of items contained in the list. 

## Example

In the following example, some screen readers would say this list has two items, instead of 
four: 

```html
<ul>
    <div class="some_class">
        <li>Example 1</li>
    </div>
    <div class="some_other_class">
        <li>Example 2</li>
        <li>Example 3</li>
        <li>Example 4</li>
    </div>
</ul>
```

To fix this, you would need to remove the `<div class="some_class">` and 
`<div class="some_other_class>` elements and ensure only `<li>` list items remain.

## Further reading

The [formal specification for the list element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/ul)
shows what is and is not permitted inside an `<ul>` and `<ol>`.

See [Technique H88](https://www.w3.org/TR/WCAG20-TECHS/H88.html) for more information.

list-not-following-semantics

September 2025

August 2025

National Library of Ireland (NLI)

Title / URL	Issues
Getting Started \| National Library of Irelandwww.nli.ie/family-history/getting-started	1
Reader's Ticket \| National Library of Irelandwww.nli.ie/visit/readers-ticket	1
NLI on the Flickr Commons \| National Library of Irelandwww.nli.ie/learn/flickr	1
Our work with the Collections \| National Library of Irelandwww.nli.ie/collections/our-work-collections	1
Visit Safely \| National Library of Irelandwww.nli.ie/visit/visit-safely	1
eResources \| National Library of Irelandwww.nli.ie/collections/e-resources	1
Opening Hours \| National Library of Irelandwww.nli.ie/visit/opening-hours	1
Getting Here \| National Library of Irelandwww.nli.ie/visit/getting-here	1
Borrow a Banner Exhibition \| National Library of Irelandwww.nli.ie/learn/borrow-banner-exhibition	1
Accessibility \| National Library of Irelandwww.nli.ie/visit/accessibility	1

Ensure lists are marked up correctly

National Library of Ireland (NLI)

Where this issue has occurred