HTML <dd> Tag

Beginner
5 min read
Updated: Oct 2026
4 examples
Live preview

Definition and Usage

The <dd> element provides the description, definition, or value for the preceding term (<dt>) in a description list (<dl>.

Use it for glossaries, FAQs-style term lists, and metadata (key–value pairs). Always keep <dd> inside a proper <dl> structure — not as a fake indent for normal paragraphs.

Baseline · Widely available.

Not deprecated. Stable across browsers since about July 2015 (and much earlier in practice).

Do not misuse for layout.

Indentation alone is not a reason to use <dl> / <dt> / <dd>. Prefer CSS margin when you only need spacing (MDN).

HTML Syntax

syntax.html
<dl><dt> term</dt><dd>details</dd></dl>

The start tag is required. The end tag may be omitted in some cases, but always write both tags while learning. Content may be flow content. Place <dd> after a <dt> or another <dd> inside <dl> (or inside a <div> group in a <dl>).

Attributes

<dd> has no element-specific attributes — only globals.

AttributeDescriptionTry it
No tag-specific attributes. Structure comes from <dl> + <dt> + <dd>.Try it

Global Attributes

The <dd> tag also supports the Global Attributes in HTML.

Live Preview

Pick a term. The <dt> names it; the <dd> describes it.

A real <dl> with one <dt> / <dd> pair.

Description list
HTML
HyperText Markup Language — the standard for structuring web pages.

dt = "HTML" · dd holds the details

HTML Examples

Short, copy-ready snippets. Use Try It Yourself for a live editor.

Example 1 — Term and Description

One <dt> followed by one <dd> inside a <dl>.

HTML
<dl>
  <dt>HTML</dt>
  <dd>HyperText Markup Language — structures web pages.</dd>
</dl>
Try It Yourself

How It Works

  1. Open a <dl> to start the description list.
  2. Name the term with <dt>.
  3. Describe it in the following <dd>.
  4. Close the list. Browsers indent the details under the term by default.

Example 2 — One Term, Several Descriptions

A single term can have more than one <dd> (MDN pattern).

HTML
<dl>
  <dt>Firefox</dt>
  <dd>A free, open-source web browser from Mozilla.</dd>
  <dd>Also a nickname for the red panda.</dd>
</dl>
Try It Yourself

How It Works

  1. Write one <dt> for the shared name.
  2. Add each meaning in its own <dd>.
  3. Keep order clear — details follow the term they describe.
  4. Optional: several <dt> synonyms can share one <dd> too.

Example 3 — Metadata Key–Value Pairs

Use <dt> for keys and <dd> for values.

HTML
<dl>
  <dt>Name</dt>
  <dd>Godzilla</dd>
  <dt>Born</dt>
  <dd>1952</dd>
  <dt>Birthplace</dt>
  <dd>Japan</dd>
</dl>
Try It Yourself

How It Works

  1. Treat each key as a <dt>.
  2. Put the value in the next <dd>.
  3. Repeat for every field in the record.
  4. Optional CSS: dt::after { content: ": "; } can add a separator for display.

Example 4 — Wrap Groups in <div>

HTML allows wrapping each name–value group in a <div> inside <dl>.

HTML
<dl>
  <div>
    <dt>Name</dt>
    <dd>Godzilla</dd>
  </div>
  <div>
    <dt>Color</dt>
    <dd>Green</dd>
  </div>
</dl>
Try It Yourself

How It Works

  1. Keep the outer <dl> as the list container.
  2. Wrap each pair in a <div> when you need group styling or attributes.
  3. Still use <dt> then <dd> inside each group.
  4. Use when helpful — plain pairs without <div> are fine for simple lists.

Edge Cases & Pitfalls

Most mistakes are missing <dl> context or using description lists only for indent.

structure

Keep dd inside dl

<dd> must live in a description list after a term (or another <dd>), not as a lone block.

semantics

Not for fake indentation

Use CSS margins for spacing. Misusing <dl> hides real meaning from readers and assistive tech.

order

Term before details

Groups are one or more <dt> then one or more <dd>. Do not reverse that pattern.

a11y

Screen reader differences

Description lists are announced differently across tools. Prefer clear term/detail wording over extra ARIA unless you know the impact.

lists

Wrong list type

Ordered steps → <ol>; plain bullets → <ul>; term/detail pairs → <dl>.

Browser Support

The <dd> element is core HTML in every browser. It is not a Node.js, Deno, or Bun API.

✓ Baseline · Widely available

<dd>

Widely available since about July 2015 (and long before as part of description lists). Chrome, Firefox, Safari, Edge, and Opera all support dd fully.

98% Global support (approx.)
Google Chrome All
Full support
Mozilla Firefox All
Full support
Apple Safari All
Full support
Microsoft Edge All
Full support
Opera All
Full support
Samsung Internet All
Full support
Internet Explorer All
Supported
<dd> Widely supported

Bottom line: Safe to use everywhere for description lists. Focus on correct dl/dt/dd structure rather than browser quirks.

Key Takeaways

  • Role: <dd> is the detail/value for a <dt> term.
  • Home: always inside <dl> (optionally grouped with <div>).
  • Flex: one term can have many <dd>s; metadata pairs are a common pattern.
  • Style: default indent is UA CSS — do not abuse the tags only for spacing.

One line: <dd> explains the <dt> that comes before it in a <dl>.

Default CSS Settings

Typical user-agent styling indents description details under the term:

default.css
dd {
  display: block;
  margin-left: 40px;
}

Adjust with margin (or modern layout) if you need a different look. Exact defaults can vary slightly by browser.

Frequently Asked Questions

The dd element provides the description, definition, or value for the preceding dt term inside a description list (dl).
No. dd belongs in a dl, after a dt (or after another dd). Using it alone for indentation is invalid semantics.
Yes. One or more dt elements can be followed by one or more dd elements in the same name-value group.
No. dd supports only the global attributes. There are no dd-specific attributes.
Browsers typically indent dd under its term. Style margin if you need a different layout — do not misuse dl/dt/dd only to indent text.
Yes. HTML allows wrapping each name-value group in a div inside dl for styling, microdata, or shared attributes on the group.

Next: del

Mark deleted text with the del element and optional cite or datetime.

del tutorial →

About the author

Mari Selvan M P
Mari Selvan M P 🔗

Developer, cloud engineer, and technical writer

  • Experience 12 years building web and cloud systems
  • Focus Full Stack Development, AWS, and Developer Education

I write practical tutorials so students and working developers can learn by doing—from databases and APIs to deployment on AWS.

9 people found this page helpful