This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.


The HTML directory element (<dir>) represents a directory, namely a collection of filenames.

Usage note: Do not use this element. Though present in the early HTML specification, it has been deprecated in HTML 4, then is obsolete in HTML5. Use the <ul> instead.

DOM Interface

This element implements the HTMLDirectoryElement interface.


Like all other HTML elements, this element supports the global attributes.

This Boolean attribute hints that the list should be rendered in a compact style. The interpretation of this attribute depends on the user agent and it doesn't work in all browsers.
Usage note: Do not use this attribute, as it has been deprecated: the <dir> element should be styled using CSS. To give a similar effect than the compact attribute, the CSS property line-height can be used with a value of 80%.

See also

  • Other list-related HTML Elements: <ol>, <ul>, <li>, <menu>;
  • CSS properties that may be specially useful to style the <dir> element:
    • The list-style property, useful to choose the way the ordinal is displayed.
    • CSS counters, useful to handle complex nested lists.
    • The line-height property, useful to simulate the deprecated compact attribute.
    • The margin property, useful to control the indent of the list.

Document Tags and Contributors

 Contributors to this page: charmander, kscarfone, tregagnon, Sheppy, Nickolay, ethertank, cers, teoli
 Last updated by: charmander,