<dl> elements must only directly contain properly-ordered <dt> and <dd> groups, <script>, <template> or <div> elements

Serious

What is the problem?

The "definition-list" accessibility rule ensures that definition lists are structured correctly using only <dl>, <dt>, and <dd> elements.

Impacted Groups

Blind
Deafblind

Why is this important?

Screen reader users rely on the correct structure of definition lists to understand the relationship between terms and their definitions. Incorrectly structured lists can confuse screen readers, making it difficult for users to access and understand the information.

How to solve this issue

To fix this issue, ensure that definition lists use the <dl> element as the container; terms are enclosed within <dt> elements; definitions are enclosed within <dd> elements; and each <dt> element is followed by a corresponding <dd> element. By following these guidelines, you can ensure that screen reader users can easily navigate and understand the content of definition lists.

Rule Information

Rule ID

definition-list

Severity

Serious

Manual Review Required

No

Rule Group

WCAG 2.0 Level A & AA Rules

Guidelines

  • WCAG 2.1 (A)
  • WCAG 2.0 (A)
  • WCAG 2.2 (A)
  • EN 301 549

Customise Guidance

You can customise each accessibility rule in SiteAlly with your own guidance, instructions and even links to your own organisation specific documentation.

Enable your website editors to resolve issues quickly with SiteAlly.

Ready to make your website accessible?

SiteAlly provides automated accessibility monitoring, detailed reports, and step-by-step guidance to help you achieve and maintain compliance.