
<!DOCTYPE html>
<html lang="en">
<!-- Generated from TermPageEx.j2 -->
    
    
    <head>

    <title>itemListElement - Schema.org Property</title>
    <meta charset="utf-8" >
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta name="description" content="Schema.org Property: itemListElement - For itemListElement values, you can use simple strings (e.g. &#34;Peter&#34;, &#34;Paul&#34;, &#34;Mary&#34;), existing entities, or use ListItem.&lt;br/&gt;&lt;br/&gt;

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.&lt;br/&gt;&lt;br/&gt;

Note: The order of elements in your mark-up is not sufficient for indicating the order or elements.  Use ListItem with a &#39;position&#39; property in such cases." />
    <link rel="shortcut icon" type="image/png" href="/docs/favicon.ico"/>
    <link rel="stylesheet" type="text/css" href="/docs/schemaorg.css" />
    <link rel="stylesheet" type="text/css" href="/docs/devnote.css" />
    <link rel="stylesheet" type="text/css" href="/docs/prettify.css" />
    <script src="/docs/prettify.js"></script>
    <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>
    <script src="/docs/schemaorg.js"></script>
<!-- <script src="/docs/debugwindow/viewconsole.js"></script> -->
    <script src="/docs/sdotermpage.js"></script>
    <link rel="stylesheet" type="text/css" href="/docs/sdotermpage.css" />
    <script src="/docs/pretty-markup/schemarama-parsing.bundle.min.js"></script>
    <script src="/docs/pretty-markup/layout.js"></script>
    <link rel="stylesheet" type="text/css" href="/docs/pretty-markup/style.css" />
    <script src="/docs/clipboard/clipboard.min.js"></script>

<link rel="canonical" href="https://schema.org/itemListElement" />
   
</head>
<body>
    <!-- Header start from PageHeader.j2 -->
<!-- Static Doc Insert PageHead -->

<div id="container">
  <div id="headerwrap">
    <div id="pagehead1" class="mobnav">
      <div class="header-block" id="pagehead-left">
        <div id="sitename2">
          <a href="/">Schema.org</a>
        </div>
        <div id="navicon2">
          <a href="javascript:void(0);" class="icon" onclick="navFunction()"><img height="40" src="/docs/menu-bar-icon-white.png"></a>
        </div>
      </div>
      <div  class="header-block header-block-right mobnav" id="pagehead-mid">
        <div id="selectionbar2">
          <ul>
            <li>
              <a href="/docs/documents.html">Documentation</a>
            </li>
            <li>
              <a href="/docs/schemas.html">Schemas</a>
            </li>
            <li>
              <a href="/docs/about.html">About</a>
            </li>
          <!--
             <li>
              <a href="/">Home</a>
            </li>
          -->
          </ul>
        </div> <!-- selectionbar -->
      </div>
      <div  class="header-block header-block-right mobnav" id="pagehead-right">
        <div id="cse-search-form2">
            <div class="gcse-searchbox-only" data-resultsUrl="/docs/search_results.html"></div>
        </div>
      </div>
    </div>
  </div>
  <div class="devnote"><b>Note</b>: you are viewing the
    <!-- <a href="http://webschemas.org/">webschemas.org</a>--> development
    version of <a href="schema.org">schema.org</a>.
    See <a href="/docs/howwework.html">How we work</a> for more details.
  </div>
</div>
  
 
<!-- Header end from PageHeader.j2 -->
    <div id="mainContent">
	    
<div id="infoblock">
	<!-- Label /  termType  / canonical URI -->
    <div id="infohead">
        <h1>itemListElement</h1>
        <em>A Schema.org Property</em>
        <br/>
        <!-- Pending/retired -->
        
        
        
    </div>
	<!-- Breadcrumb display of term inheritance -->
    <div class="superPaths">
    
         
					
					
    
    
    <a href="/Thing"  
        class="core" title="Thing">Thing</a>  > 
					
					
    
    
    <a href="/Property"  
        class="core" title="Property">Property</a> 
					 > 
					
    
    
    <a href="/itemListElement"  
        class="core" title="itemListElement">itemListElement</a>
        <br/>
    
    </div>
    <!-- More Block -->
    <div>
            <div id='infobox' style='text-align: right;' role="checkbox" aria-checked="false">
                <label for="morecheck"><b><span style="cursor: pointer;">[more...]</span></b></label>
            </div>
            <input type='checkbox' checked="checked" style='display: none' id=morecheck><div id='infomsg' style='background-color: #EEEEEE; text-align: left; padding: 0.5em;'>
            <ul><li> <span class="canonicalUrl">Canonical URL: http://schema.org/itemListElement</span> </li>
            
                <li><a href='https://docs.google.com/a/google.com/forms/d/1krxHlWJAO3JgvHRZV9Rugkr9VYnMdrI10xbGsWt733c/viewform?entry.1174568178&entry.41124795=http://schema.org/itemListElement&entry.882602760=Property'>Leave public feedback on this term &#128172;</a></li><li><a href='https://github.com/schemaorg/schemaorg/issues?q=is%3Aissue+is%3Aopen+itemListElement'>Check for open issues.</a></li></ul>
    </div>
    </div>
	
	<!-- Description of term -->
    <div class="description">For itemListElement values, you can use simple strings (e.g. "Peter", "Paul", "Mary"), existing entities, or use ListItem.<br/><br/>

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.<br/><br/>

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.</div>
        
    
	
</div> <!-- infoblock -->
		
		
        
        
            
            
            <table class="definition-table">
                <thead><tr><th>Values expected to be one of these types</th></tr></thead>
                <tr><td><code>
                
                    
                        
    
    
    <a href="/ListItem"  
        class="core" title="ListItem">ListItem</a><br/>
                    
                
                    
                        
    
    
    <a href="/Text"  
        class="core" title="Text">Text</a><br/>
                    
                
                    
                        
    
    
    <a href="/Thing"  
        class="core" title="Thing">Thing</a>
                    
                
                </td></code></tr>
            </table>
            <table class="definition-table">
                <thead><tr><th>Used on these types</th></tr></thead>
                <tr><td><code>
                
                    
                        
    
    
    <a href="/ItemList"  
        class="core" title="ItemList">ItemList</a>
                    
                
                </td></code></tr>
            </table>
        
        	
		

		
        <!-- List subtypes/subproperties -->
        
            
            
    	    
    	    	<!-- List subs (Subtypes/subproperties/enumeration members/etc.) for Term -->


        
			
		<!-- list supersedes and superseded references -->
		


        <!-- list source references and acknowledgements -->
		




		<!-- list examples  -->
		<!-- Examples block for term: itemListElement-->

<div id="examplespannel" style="width:auto; overflow-x: auto;">

<b><a  id="examples" title="Link: #examples" href="#examples" class="clickableAnchor"  >Examples</a></b><br/><br/>

<div class="example-head">
        <a  id="eg-0377" title="Link: #eg-0377" href="#eg-0377" class="clickableAnchor" >Example 1</a>			<div class="tooltip">	
				<button class="clip clipbutton eg-0377" data-clipboard-target=".ds-tab.selected.eg-0377 .clipsource" title="Copy example to clipboard">
				    <img src="/docs/clipboard/clippy.svg" width="13" alt="Copy to clipboard">
				</button>
				<span class="tooltiptext eg-0377">Copied</span>
			</div>
</div>
<div class='ds-selector-tabs ds-selector'>
  <div class='selectors'>
    <a data-selects='original_html' class='selected'>No Markup</a>
    <a data-selects='microdata' class=''>Microdata</a>
    <a data-selects='rdfa' class=''>RDFa</a>
    <a data-selects='jsonld' class=''>JSON-LD</a>
    <a data-selects='structure' class='extabs'>Structure</a>
  </div>

<div class="ds-tab eg-0377 original_html selected">
  <div class="ds-tab-note" >Example notes or example HTML without markup.</div>
  <pre class="ds-tab-content prettyprint lang-html linenums clipsource ">
&lt;ol&gt;
  &lt;li&gt;
    &lt;a href=&#34;https://example.com/dresses&#34;&gt;Dresses&lt;/a&gt;
  &lt;/li&gt;
  &lt;li&gt;
    &lt;a href=&#34;https://example.com/dresses/real&#34;&gt;Real Dresses&lt;/a&gt;
  &lt;/li&gt;
&lt;/ol&gt;
</pre>
</div>

<div class="ds-tab eg-0377 microdata">
  <div class="ds-tab-note" >Example encoded as <a class="ds-tab-note" href="https://en.wikipedia.org/wiki/Microdata_(HTML)">Microdata</a> embedded in HTML.</div>
  <pre class="ds-tab-content prettyprint lang-html linenums clipsource ">
&lt;ol itemscope itemtype=&#34;https://schema.org/BreadcrumbList&#34;&gt;
  &lt;li itemprop=&#34;itemListElement&#34; itemscope
      itemtype=&#34;https://schema.org/ListItem&#34;&gt;
    &lt;a itemprop=&#34;item&#34; href=&#34;https://example.com/dresses&#34;&gt;
    &lt;span itemprop=&#34;name&#34;&gt;Dresses&lt;/span&gt;&lt;/a&gt;
    &lt;meta itemprop=&#34;position&#34; content=&#34;1&#34; /&gt;
  &lt;/li&gt;
  &lt;li itemprop=&#34;itemListElement&#34; itemscope
      itemtype=&#34;https://schema.org/ListItem&#34;&gt;
    &lt;a itemprop=&#34;item&#34; href=&#34;https://example.com/dresses/real&#34;&gt;
    &lt;span itemprop=&#34;name&#34;&gt;Real Dresses&lt;/span&gt;&lt;/a&gt;
    &lt;meta itemprop=&#34;position&#34; content=&#34;2&#34; /&gt;
  &lt;/li&gt;
&lt;/ol&gt;
</pre>
</div>

<div class="ds-tab eg-0377 rdfa">
  <div class="ds-tab-note" >Example encoded as <a class="ds-tab-note" href="https://en.wikipedia.org/wiki/RDFa">RDFa</a> embedded in HTML.</div>
  <pre class="ds-tab-content prettyprint lang-html linenums clipsource ">
&lt;ol vocab=&#34;https://schema.org/&#34; typeof=&#34;BreadcrumbList&#34;&gt;
  &lt;li property=&#34;itemListElement&#34; typeof=&#34;ListItem&#34;&gt;
    &lt;a property=&#34;item&#34; typeof=&#34;WebPage&#34; href=&#34;https://example.com/dresses&#34;&gt;
     &lt;span property=&#34;name&#34;&gt;Dresses&lt;/span&gt;&lt;/a&gt;
     &lt;meta property=&#34;position&#34; content=&#34;1&#34;&gt;
  &lt;/li&gt;
  &lt;li property=&#34;itemListElement&#34; typeof=&#34;ListItem&#34;&gt;
    &lt;a property=&#34;item&#34; typeof=&#34;WebPage&#34; href=&#34;https://example.com/dresses/real&#34;&gt;
    &lt;span property=&#34;name&#34;&gt;Real Dresses&lt;/span&gt;&lt;/a&gt;
    &lt;meta property=&#34;position&#34; content=&#34;2&#34;&gt;
  &lt;/li&gt;
&lt;/ol&gt;
</pre>
</div>

<div class="ds-tab eg-0377 jsonld ">
  <div class="ds-tab-note" >Example encoded as <a class="ds-tab-note" href="https://en.wikipedia.org/wiki/JSON-LD">JSON-LD</a> in a HTML script tag.</div>
  <pre class="ds-tab-content prettyprint lang-html linenums clipsource ">
&lt;script type=&#34;application/ld+json&#34;&gt;
{
 &#34;@context&#34;: &#34;https://schema.org&#34;,
 &#34;@type&#34;: &#34;BreadcrumbList&#34;,
 &#34;itemListElement&#34;:
 [
  {
   &#34;@type&#34;: &#34;ListItem&#34;,
   &#34;position&#34;: 1,
   &#34;item&#34;:
   {
    &#34;@id&#34;: &#34;https://example.com/dresses&#34;,
    &#34;name&#34;: &#34;Dresses&#34;
    }
  },
  {
   &#34;@type&#34;: &#34;ListItem&#34;,
  &#34;position&#34;: 2,
  &#34;item&#34;:
   {
     &#34;@id&#34;: &#34;https://example.com/dresses/real&#34;,
     &#34;name&#34;: &#34;Real Dresses&#34;
   }
  }
 ]
}
&lt;/script&gt;
</pre>
</div>

<div class="ds-tab eg-0377 structure extabs" data-ex="eg-0377">
  <div class="ds-tab-note" >Structured representation of the JSON-LD example.</div>
  <div class="ds-tab-content structureout extabs eg-0377" style="margin-left: 5px;"> </div>
  <div class="structuretext clipsource extabs eg-0377"></div>
</div>


<div class="payload eg-0377" style="display: none;">{
 &#34;@context&#34;: &#34;https://schema.org&#34;,
 &#34;@type&#34;: &#34;BreadcrumbList&#34;,
 &#34;itemListElement&#34;:
 [
  {
   &#34;@type&#34;: &#34;ListItem&#34;,
   &#34;position&#34;: 1,
   &#34;item&#34;:
   {
    &#34;@id&#34;: &#34;https://example.com/dresses&#34;,
    &#34;name&#34;: &#34;Dresses&#34;
    }
  },
  {
   &#34;@type&#34;: &#34;ListItem&#34;,
  &#34;position&#34;: 2,
  &#34;item&#34;:
   {
     &#34;@id&#34;: &#34;https://example.com/dresses/real&#34;,
     &#34;name&#34;: &#34;Real Dresses&#34;
   }
  }
 ]
}</div>
</div>

</div>
		
    </div> <!-- mainContent -->
	<!-- Footer start from PageFooter.j2 -->
    
    <div id="footer"><p>
      <div id="versioninfo">
          V11.0<br/>
          2020-11-30
      </div>
      <a href="/docs/terms.html">Terms and conditions</a>
    </div>

    <script>
      (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
      (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
      m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
      })(window,document,'script','//www.google-analytics.com/analytics.js','ga');

      ga('create', 'UA-52672119-1', 'auto');
      ga('send', 'pageview');

    </script>
<!-- Footer end from PageFooter.j2 -->
    
<script type="application/ld+json">
{
  "@context": {
    "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
    "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
    "schema": "http://schema.org/",
    "xsd": "http://www.w3.org/2001/XMLSchema#"
  },
  "@id": "schema:itemListElement",
  "@type": "rdf:Property",
  "rdfs:comment": "For itemListElement values, you can use simple strings (e.g. \"Peter\", \"Paul\", \"Mary\"), existing entities, or use ListItem.<br/><br/>\n\nText 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.<br/><br/>\n\nNote: 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.",
  "rdfs:label": "itemListElement",
  "schema:domainIncludes": {
    "@id": "schema:ItemList"
  },
  "schema:rangeIncludes": [
    {
      "@id": "schema:ListItem"
    },
    {
      "@id": "schema:Text"
    },
    {
      "@id": "schema:Thing"
    }
  ]
}
</script>
    

</body>
</html>