HTML <ul> Element

The <ul> element represents an unordered list of items where the order of the items is not significant. Each item in the list is represented by an <li> element and is typically displayed with a bullet marker.

Syntax

<ul>
  <li>HTML</li>
  <li>CSS</li>
  <li>JavaScript</li>
</ul>

Attributes

The <ul> element supports the global HTML attributes. It does not have any element-specific attributes.

Example

This example uses a <ul> element with three <li> elements to create a simple unordered list.

Play in Editor

Usage Notes

Use the <ul> element when a group of related items does not need to appear in a particular sequence. If the order of the items is meaningful, use the <ol> element instead.

Each item in an unordered list is represented by an <li> element. Lists can also be nested by placing another <ul> or <ol> inside an <li> element.

Browsers normally display unordered list items with bullet markers. Use CSS properties such as list-style-type, list-style-position, and list-style-image when you need to change the appearance of the markers.

Accessibility

Use semantic list markup when content is logically a list rather than creating visual bullets with ordinary paragraphs or other elements. The <ul> and <li> elements provide list structure that browsers and assistive technologies can identify and communicate to users.

Browser Support

Baseline: Widely available indicates a feature has been supported by core browsers for at least 30 months. At this stage, the feature is considered stable and safe for most websites to use without needing to worry about compatibility issues or fallbacks, as it is supported by the vast majority of users' devices and browser versions.

For detailed browser compatibility information, see Can I Use: HTML <ul> Element .

The <ul> element is related to other list elements, including <li> for individual list items, <ol> for ordered lists, and <dl> for description lists.

Specifications

The <ul> element is defined in the WHATWG HTML Living Standard .