HTML tagLists

<dd>

The description or value assigned to a `<dt>` name in a description list.

Display
block
Closing tag
Required
Permitted content
Flow content
On this page

Example

#
HTML
<dl>
  <dt>Mentor</dt>
  <dd>An experienced developer who reviews your projects.</dd>
  <dd>Gives you hints when you get stuck on a hard exercise.</dd>
  <dt>Final project</dt>
  <dd>A page you build on your own and add to your portfolio.</dd>
</dl>
Preview

Definition and usage

#

The <dd> element (from description details) holds the description, definition, or value for the <dt> that precedes it. It can contain any flow content: paragraphs, lists, images, or links.

You can assign several <dd> elements to one name, for example several meanings of a word or several technologies in a course description. By default the browser indents descriptions 40 pixels from the left edge.

That indent is only a default style. If you lay out a description list in two columns, you usually reset the margin right away: dd { margin: 0; }.

Syntax

#
Syntax
<dd>description</dd>

Attributes

#

This element has no attributes of its own. It supports the global attributes, such as class, id and hidden.

Default CSS

#

Most browsers display this element with these default styles:

CSS
dd {
  display: block;
  margin-inline-start: 40px;
}

Browser support

#

Widely available

Works in all modern browsers, phones included. You can use it without worry.

  • Chrome
  • Edge
  • Firefox
  • Safari

Good practices

#
  • <dd> can’t stand on its own. It is always part of a <dl> and follows a <dt> or another <dd>.
  • Don’t use <dd> to indent ordinary text. Set the indent in CSS with the margin-inline-start or padding-inline-start property.

Related entries

#

Practise it in lessons

#

Spotted a mistake or missing an example? Write to us.