CKTIS / HTML
dl — description list
The `dl` element represents name–value associations, such as metadata, questions and answers, or terms and definitions. Names belong in `dt` elements and their corresponding values in `dd` elements.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<dl>
<dt>Name</dt>
<dd>Value</dd>
</dl>dl is a list of name–value groups, not just a dictionary of definitions. Each group contains one or more dt elements followed by one or more dd elements. Multiple names can share values; consecutive dd elements represent distinct values. Put paragraphs belonging to one value inside a single dd.
Place groups directly inside dl, or wrap each group in a div, for example for styling. Do not mix these structures within one list. Both structures also allow script-supporting elements. The list may be empty.
dl requires both opening and closing tags and supports global attributes. The order of groups, names, and values can matter. Avoid repeating the same name in separate dt elements. A dt alone does not mark a term as being formally defined; use dfn for that.
Examples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Product details</title>
<dl>
<div>
<dt>Model</dt>
<dd>Atlas</dd>
</div>
<div>
<dt>Available colors</dt>
<dd>Blue</dd>
<dd>Green</dd>
</div>
</dl>
</html>Result
Model Atlas Available colors Blue Green
The displayed code and declared result were verified in an isolated environment using the method recorded in the verification evidence for this exact version.