Library services for researchers | University of Dundee, UK

Equality Diversity and Inclusion | University of Dundee, UK

Find a job | University of Dundee, UK

Research at the University of Dundee | University of Dundee, UK

Strategy and vision | University of Dundee, UK

Sustainability | University of Dundee, UK

Professional Services | University of Dundee, UK

About the University of Dundee | University of Dundee, UK

Work for the University of Dundee | University of Dundee, UK

Research impact | University of Dundee, UK

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

August 2025

July 2025

University of Dundee

	Title / URL	Issues
	Library services for researchers \| University of Dundee, UKwww.dundee.ac.uk/library/research	2
	Equality Diversity and Inclusion \| University of Dundee, UKwww.dundee.ac.uk/equality-diversity	2
	Find a job \| University of Dundee, UKwww.dundee.ac.uk/work-for-us/jobs	1
	Research at the University of Dundee \| University of Dundee, UKwww.dundee.ac.uk/research	1
	Strategy and vision \| University of Dundee, UKwww.dundee.ac.uk/about/strategy-vision	1
	Sustainability \| University of Dundee, UKwww.dundee.ac.uk/about/sustainability	1
	Professional Services \| University of Dundee, UKwww.dundee.ac.uk/about/organisation/professional-services	1
	About the University of Dundee \| University of Dundee, UKwww.dundee.ac.uk/about	1
	Work for the University of Dundee \| University of Dundee, UKwww.dundee.ac.uk/work-for-us	1
	Research impact \| University of Dundee, UKwww.dundee.ac.uk/research/impact	1

Ensure lists are marked up correctly

University of Dundee

Where this issue has occurred