: The Ordered List element - HTML: HyperText Markup Language | MDN (original) (raw)

Baseline

Widely available

The <ol> HTML element represents an ordered list of items — typically rendered as a numbered list.

Try it

<ol>
  <li>Mix flour, baking powder, sugar, and salt.</li>
  <li>In another bowl, mix eggs, milk, and oil.</li>
  <li>Stir both mixtures together.</li>
  <li>Fill muffin tray 3/4 full.</li>
  <li>Bake for 20 minutes.</li>
</ol>
li {
  font:
    1rem "Fira Sans",
    sans-serif;
  margin-bottom: 0.5rem;
}

Attributes

This element also accepts the global attributes.

reversed

This Boolean attribute specifies that the list's items are in reverse order. Items will be numbered from high to low.

start

An integer to start counting from for the list items. Always an Arabic numeral (1, 2, 3, etc.), even when the numbering type is letters or Roman numerals. For example, to start numbering elements from the letter "d" or the Roman numeral "iv," use start="4".

type

Sets the numbering type:

The specified type is used for the entire list unless a different type attribute is used on an enclosed

  • element.

    **Note:**Unless the type of the list number matters (like legal or technical documents where items are referenced by their number/letter), use the CSS list-style-type property instead.

    Usage notes

    Typically, ordered list items display with a preceding marker, such as a number or letter.

    The <ol> and

    (or the synonym ) elements may nest as deeply as desired, alternating between <ol>, <ul> (or <menu>) as needed.

    The <ol> and

    elements both represent a list of items. The difference is with the <ol> element, the order is meaningful. For example:

    To determine which list to use, try changing the order of the list items; if the meaning changes, use the <ol> element — otherwise you can use

    otherwise, or if your list is a menu.

    Examples

    Basic example

    <ol>
      <li>Fee</li>
      <li>Fi</li>
      <li>Fo</li>
      <li>Fum</li>
    </ol>
    

    Result

    Using Roman Numeral type

    <ol type="i">
      <li>Introduction</li>
      <li>List of Grievances</li>
      <li>Conclusion</li>
    </ol>
    

    Result

    Using the start attribute

    <p>Finishing places of contestants not in the winners' circle:</p>
    
    <ol start="4">
      <li>Speedwalk Stu</li>
      <li>Saunterin' Sam</li>
      <li>Slowpoke Rodriguez</li>
    </ol>
    

    Result

    Nesting lists

    <ol>
      <li>first item</li>
      <li>
        second item
        <!-- closing </li> tag is not here! -->
        <ol>
          <li>second item first subitem</li>
          <li>second item second subitem</li>
          <li>second item third subitem</li>
        </ol>
      </li>
      <!-- Here's the closing </li> tag -->
      <li>third item</li>
    </ol>
    

    Result

    Unordered list inside ordered list

    <ol>
      <li>first item</li>
      <li>
        second item
        <!-- closing </li> tag is not here! -->
        <ul>
          <li>second item first subitem</li>
          <li>second item second subitem</li>
          <li>second item third subitem</li>
        </ul>
      </li>
      <!-- Here's the closing </li> tag -->
      <li>third item</li>
    </ol>
    

    Result

    Technical summary

    Content categories Flow content, and if the
      element's children include at least one
    1. element,palpable content.
    Permitted content Zero or more
  • ,