itemListElement - Schema.org Property

<!DOCTYPE html> <html lang="en">  <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. "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." /> <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/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>   <div class="devnote"><b>Note</b>: You are viewing the development version of <a href="https://schema.org">Schema.org</a>. See <a href="/docs/howwework.html">how we work</a> for more details. </div> <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> <div class="header-block header-block-right mobnav" id="pagehead-mid"> <div id="selectionbar2"> <ul> <li> <a href="/docs/documents.html">Docs</a> </li> <li> <a href="/docs/schemas.html">Schemas</a> </li> <li> <a href="https://validator.schema.org">Validate</a> </li> <li> <a href="/docs/about.html">About</a> </li> </ul> </div>  </div> <div class="header-block header-block-right mobnav" id="pagehead-right"> <div id="cse-search-form2" class="live-only"> <div class="gcse-searchbox-only" data-resultsUrl="/docs/search_results.html"></div> </div> </div> <div class="header-block mobnav" id="navicon2"> <a href="javascript:void(0);" class="icon" onclick="navFunction()"> <svg id="open" width="24px" height="24px" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg"> <g clip-path="url(#clip0_3560_173)"> <path d="M3 18V16H21V18H3ZM3 13V11H21V13H3ZM3 8V6H21V8H3Z" fill="#444746"/> </g> <defs> <clipPath id="clip0_3560_173"> <rect width="24" height="24" fill="white"/> </clipPath> </defs> </svg> <svg id="close" width="24px" height="24px" viewBox="0 -960 960 960" fill="#444746" xmlns="http://www.w3.org/2000/svg"> <path d="m256-200-56-56 224-224-224-224 56-56 224 224 224-224 56 56-224 224 224 224-56 56-224-224-224 224Z"/> </svg> </a> </div> </div> </div> <div class="header-bottom"></div> </div>  <div id="mainContent"> <div id="infoblock" class="jumptarget" title="Details">  <div id="infohead"> <h1>itemListElement</h1> <div class="infotype">A Schema.org Property</div>  </div>  <div class="superPaths" itemscope itemtype="https://schema.org/BreadcrumbList"> <span itemscope itemprop="itemListElement" itemtype="https://schema.org/ListItem"> <meta itemprop="name" content="Thing" /> <meta itemprop="position" content="1" /> <a href="/Thing" itemprop="item" class="core" title="Thing">Thing</a> </span> > <span itemscope itemprop="itemListElement" itemtype="https://schema.org/ListItem"> <meta itemprop="name" content="Property" /> <meta itemprop="position" content="2" /> <a href="/Property" itemprop="item" class="core" title="Property">Property</a> </span> :: <span itemscope itemprop="itemListElement" itemtype="https://schema.org/ListItem"> <meta itemprop="name" content="itemListElement" /> <meta itemprop="position" content="3" /> <a href="/itemListElement" itemprop="item" class="core" title="itemListElement">itemListElement</a> </span> <br/> </div>  <div> <div id='infobox' style='text-align: right; padding-right: 5px;' 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: https://schema.org/itemListElement</span> </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>  <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>  <div class="jumptarget" id="values" title="Values"> <h3>Values expected to be one of these types</h3> <code><ul> <li> <a href="/ListItem" class="core" title="ListItem">ListItem</a></li> <li> <a href="/Text" class="core" title="Text">Text</a></li> <li> <a href="/Thing" class="core" title="Thing">Thing</a></li> </code></ul> </div> <div class="jumptarget" id="types" title="Used on"> <h3>Used on these types</h3> <code><ul> <li> <a href="/ItemList" class="core" title="ItemList">ItemList</a></li> </code></ul> </div>       <div id="examplespannel" class="jumptarget" title="Examples"> <h3>Examples</h3> <div class="example-head"> <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="18" alt="Copy to clipboard" /> </button> <a id="eg-0377" title="Link: #eg-0377" href="#eg-0377" class="clickableAnchor" >Example 1</a> <div class="tooltip"> <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 "> <ol> <li> <a href="https://example.com/dresses">Dresses</a> </li> <li> <a href="https://example.com/dresses/real">Real Dresses</a> </li> </ol> </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 "> <ol itemscope itemtype="https://schema.org/BreadcrumbList"> <li itemprop="itemListElement" itemscope itemtype="https://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="https://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> </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 "> <ol vocab="https://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> </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 "> <script type="application/ld+json"> { "@context": "https://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> </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;">{ "@context": "https://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" } } ] }</div> </div> </div> </div>   <div id="footer"> <p><a href="/docs/terms.html">Terms and conditions</a></p> <div id="versioninfo"> <span class="sep">•</span> Schema.org <span class="sep">•</span> V28.1 <span class="sep">|</span> 2024-11-22 </div> </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>  <script type="application/ld+json"> { "@context": { "brick": "https://brickschema.org/schema/Brick#", "csvw": "http://www.w3.org/ns/csvw#", "dc": "http://purl.org/dc/elements/1.1/", "dcam": "http://purl.org/dc/dcam/", "dcat": "http://www.w3.org/ns/dcat#", "dcmitype": "http://purl.org/dc/dcmitype/", "dcterms": "http://purl.org/dc/terms/", "doap": "http://usefulinc.com/ns/doap#", "foaf": "http://xmlns.com/foaf/0.1/", "odrl": "http://www.w3.org/ns/odrl/2/", "org": "http://www.w3.org/ns/org#", "owl": "http://www.w3.org/2002/07/owl#", "prof": "http://www.w3.org/ns/dx/prof/", "prov": "http://www.w3.org/ns/prov#", "qb": "http://purl.org/linked-data/cube#", "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#", "rdfs": "http://www.w3.org/2000/01/rdf-schema#", "schema": "https://schema.org/", "sh": "http://www.w3.org/ns/shacl#", "skos": "http://www.w3.org/2004/02/skos/core#", "sosa": "http://www.w3.org/ns/sosa/", "ssn": "http://www.w3.org/ns/ssn/", "time": "http://www.w3.org/2006/time#", "vann": "http://purl.org/vocab/vann/", "void": "http://rdfs.org/ns/void#", "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.\\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.\\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:Thing" }, { "@id": "schema:Text" }, { "@id": "schema:ListItem" } ] } </script> </body> </html>

CINXE.COM

itemListElement - Schema.org Property