ListItem

schema:Thing > schema:Intangible > schema:ListItem

An list item, e.g. a step in a checklist or how-to description.
PropertyExpected TypeDescription
Properties from schema:ListItem
schema:item schema:Thing An entity represented by an entry in a list (e.g. an 'artist' in a list of 'artists')’.
schema:nextItem schema:ListItem A link to the ListItem that follows the current one.
schema:position schema:Text  or
schema:Integer 
The position of an item in a series or sequence of items.
schema:previousItem schema:ListItem A link to the ListItem that preceeds the current one.
Properties from schema:Thing
schema:additionalType schema:URL An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. In RDFa syntax, it is better to use the native RDFa syntax - the 'typeof' attribute - for multiple types. Schema.org tools may have only weaker understanding of extra types, in particular those defined externally.
schema:alternateName schema:Text An alias for the item.
schema:description schema:Text A short description of the item.
schema:image schema:ImageObject  or
schema:URL 
An image of the item. This can be a URL or a fully described ImageObject.
schema:name schema:Text The name of the item.
schema:potentialAction schema:Action Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
schema:sameAs schema:URL URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Freebase page, or official website.
schema:url schema:URL URL of the item.


Instances of schema:ListItem may appear as values for the following properties
PropertyOn TypesDescription
schema:itemListElement schema:ItemList For itemListElement values, you can use simple strings (e.g. "Peter", "Paul", "Mary"), existing entities, or use ListItem.

Text values are best if the elements in the list are plain strings. Existing entities are best for a simple, unordered list of existing things in your data. ListItem is used with ordered lists when you want to provide additional context about the element in that list or when the same item might be in different places in different lists.

Note: The order of elements in your mark-up is not sufficient for indicating the order or elements. Use ListItem with a 'position' property in such cases.
schema:nextItem schema:ListItem A link to the ListItem that follows the current one.
schema:previousItem schema:ListItem A link to the ListItem that preceeds the current one.

Prefixes used:

  • schema: http://schema.org/
  • Examples

    <ol>
      <li>
        <a href="https://example.com/dresses">Dresses</a>
      </li>
    › <li>
        <a href="https://example.com/dresses/real">Real Dresses</a>
      </li>
    </ol>
    
    <ol itemscope itemtype="http://schema.org/BreadcrumbList">
      <li itemprop="itemListElement" itemscope
          itemtype="http://schema.org/ListItem">
        <a itemprop="item" href="https://example.com/dresses">
        <span itemprop="name">Dresses</span></a>
        <meta itemprop="position" content="1" />
      </li>
    › <li itemprop="itemListElement" itemscope
          itemtype="http://schema.org/ListItem">
        <a itemprop="item" href="https://example.com/dresses/real">
        <span itemprop="name">Real Dresses</span></a>
        <meta itemprop="position" content="2" />
      </li>
    </ol>
    
    <ol vocab="http://schema.org/" typeof="BreadcrumbList">
      <li property="itemListElement" typeof="ListItem">
        <a property="item" typeof="WebPage" href="https://example.com/dresses">
         <span property="name">Dresses</span></a>
         <meta property="position" content="1">
      </li>
    › <li property="itemListElement" typeof="ListItem">
        <a property="item" typeof="WebPage" href="https://example.com/dresses/real">
        <span property="name">Real Dresses</span></a>
        <meta property="position" content="2">
      </li>
    </ol>
    
    <script type="application/ld+json>
    {
     "@context": "http://schema.org",
     "@type": "BreadcrumbList",
     "itemListElement":
     [
      {
       "@type": "ListItem",
       "position": 1,
       "item":
       {
        "@id": "https://example.com/dresses",
        "name": "Dresses"
        }
      },
      {
       "@type": "ListItem",
      "position": 2,
      "item":
       {
         "@id": "https://example.com/dresses/real",
         "name": "Real Dresses"
       }
      }
     ]
    }
    </script>
    

    Schema.org Version 1.93
    BiblioGraph.net Version 1.1
    Code Version 1.1