Ensure all child dd and dt elements have a dl parent

Definition list items (<dt> and <dd>) must be wrapped in a parent <dl> element to ensure that screen readers can properly announce them. Lighthouse reports when definition list items are not wrapped in <dl> elements:

Lighthouse audit showing definition list items are not wrapped in <dl> elements
Fig. 1 — Defintion list items are not wrapped in <dl> elements

How to fix this problem

To fix this problem, wrap the definition list items in parent dl elements to ensure the list follows the proper hierarchy.

Definition list items require dl elements around the list, dt elements for each term, and dd elements for each definition. Each set of dt elements must be followed by one or more dd elements. For example:

<dl>
<dt>Trail shoe</dt>
<dd>Extra grip for uneven, natural survaces, such as forest trails.</dd>
<dt>Road shoe</dt>
<dd>Extra cushioning for hard surfaces, such as sidewalks and roads.</dd>
</dl>

Learn more in <dt> and <dd> elements must be contained by a <dl>.

More information

Last updated: Improve article