The WebPlatform project has been discontinued when the Stewards partnership agreement ended in September 2015. This site has been frozen, and the assets we have created will remain.


< html‎ | elements
Jump to: navigation, search

ul – unordered list

This article is Ready to Use.

W3C Recommendation


For technical reasons, the title of this article is not the text used to call this API. Instead, use ul


The ul element is used to define an unordered list. The element encloses one or more list items, enclosed in li elements.

Overview Table

DOM Interface HTMLUListElement
Permitted contents One of the following:
  • Either: Zero or more li elements.
  • Or: A template element.
  • Or: any combination of the above two
Permitted parents Any element that can contain flow content.
Tag omission A ul element must have both a start tag and an end tag.

The unordered list, represented by the ul element, is most often used to group a list of items, enclosed in li elements, together in a semantic way. Usually, the order in which the items are presented is not important.


This example uses the ul element to create a bulleted list.



Example with nested lists


  <li>Alice <ul>
  <li>Bob <ul>
  <li>Carol <ul>

Typical browser default CSS properties for the ul element.


display: block;
list-style-type: disc;
margin-top: 16px;
margin-bottom: 16px;



The type attribute sets the list type for all ensuing lists unless a different type value is set. The ul element inherits its line-height from the height of the font attribute for the body. For example, if the font-size attribute for the body is larger than the font-size attribute for the ul element, the list items in the ul are spaced according to the font-size of the body.

Related specifications

Specification Status Related Changes
HTML 5.1 W3C Working Draft
HTML 5 W3C Recommendation
HTML 4.01 W3C Recommendation

See also

Other articles


This article contains content originally from external sources.

Portions of this content come from the Microsoft Developer Network: [Windows Internet Explorer API reference Article]