Back to HTML

Description Lists in HTML: dl, dt and dd

Coding Tutorials Team 20 July 2026

The description list is the least used of the three list types and the one that solves a problem people usually solve badly. Whenever content consists of pairs, where one part names something and the other describes it, this is the element built for the job.

The three elements

A description list wraps the whole group. Each term uses a dt element and each description uses a dd element.

<dl> <dt>Selector</dt> <dd>The part of a CSS rule that decides which elements it applies to.</dd> <dt>Declaration</dt> <dd>A property and value pair inside a rule.</dd> </dl>

Browsers indent the descriptions by default, which is the visual signal that they belong to the term above. Like every default, it is a starting point rather than something you are stuck with.

It was renamed for a reason

This was originally the definition list, and it was narrowed in most people's minds to glossaries alone. The rename to description list reflects a much broader intent. Any name and value pairing qualifies, which covers a great deal of common content.

  • Product specifications, where each attribute has a value.
  • Article metadata such as author, publication date and reading time.
  • Frequently asked questions, where the question is the term and the answer is the description.
  • Contact details, pairing a label with a phone number or address.
  • A key explaining the symbols used in a chart.

Each of these is regularly built with divs and classes instead, which works visually and records nothing about the relationship between the two halves.

Pairings do not have to be one to one

A term may have several descriptions, and several terms may share one description. Both are valid and useful.

<dl> <dt>Colour</dt> <dd>Slate</dd> <dd>Charcoal</dd> <dt>Bin</dt> <dt>Trash can</dt> <dd>A container for waste.</dd> </dl>

The grouping rule is that consecutive terms all belong to the descriptions that follow them, up to the next term. This is how synonyms and multi valued attributes are expressed.

Wrapping pairs in a div

Styling a description list is awkward because the terms and descriptions are siblings rather than being grouped. For this reason the specification permits a div around each pair, purely to give CSS something to work with.

<dl> <div class="spec-row"> <dt>Weight</dt> <dd>1.2 kg</dd> </div> </dl>

This is the one place a div is explicitly allowed inside a list, and it is a deliberate exception rather than an oversight. Nothing else may sit directly inside the list.

When a table is the better choice

The distinction between a description list and a table trips people up. A table is for data with two dimensions, where each cell sits at the intersection of a row and a column and the column heading matters. Comparing three products across five attributes is a table.

A description list is one dimensional: a flat sequence of pairs with no columns. The specifications of one product is a description list. The specifications of several products side by side is a table. Choosing wrongly makes the content harder to interpret for anyone navigating with assistive technology, which handles the two structures very differently.

What it is not for

Dialogue was a documented use in an earlier draft and was explicitly removed. Speaker and line pairs should use paragraphs with the speaker marked up inside them. The element is also not a general layout device, so reaching for it to get an indented block is the same category of mistake as using a blockquote for indentation.

Styling it as two columns

The most common presentation puts terms in a left column and descriptions on the right, and Grid handles this in a few lines. Making the list a grid with two columns places each term and its description on one row automatically, since they alternate in the source order.

dl { display: grid; grid-template-columns: max-content 1fr; gap: 8px 24px; }

This works cleanly only while each term has exactly one description. Once a term has two, the alternation breaks and the wrapping div described above becomes necessary, with the grid applied to the div instead of the list.

Marking up a set of questions

A frequently asked questions block is a natural fit, with each question as a term and each answer as a description. It is worth noting that answers can contain full block content, so a multi paragraph answer with its own list inside is perfectly valid.

If you want the answers to expand and collapse, the details and summary elements are the better choice, since they provide that behaviour natively with keyboard support included. The two approaches are not interchangeable: one describes a relationship between pairs, the other provides a disclosure widget.

Why bother

The honest answer is that visually you can reproduce any of this with divs. What you cannot reproduce is the relationship, which is available to screen readers, to search engines building structured summaries, and to anything else parsing your page. Choosing the element that already means what your content means costs nothing and preserves information that would otherwise exist only in the layout.