Thing > CreativeWork > ItemList

A list of items of any sort—for example, Top 10 Movies About Weathermen, or Top 100 Party Songs. Not to be confused with HTML lists, which are often used only for formatting.
PropertyExpected TypeDescription
Properties from Thing
additionalType 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.
description Text A short description of the item.
image URL URL of an image of the item.
name Text The name of the item.
sameAs 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.
url URL URL of the item.
Properties from CreativeWork
about Thing The subject matter of the content.
accountablePerson Person Specifies the Person that is legally accountable for the CreativeWork.
aggregateRating AggregateRating The overall rating, based on a collection of reviews or ratings, of the item.
alternativeHeadline Text A secondary title of the CreativeWork.
associatedMedia MediaObject The media objects that encode this creative work. This property is a synonym for encodings.
audience Audience The intended audience of the item, i.e. the group for whom the item was created.
audio AudioObject An embedded audio object.
author Organization or Person The author of this content. Please note that author is special in that HTML 5 provides a special mechanism for indicating authorship via the rel tag. That is equivalent to this and may be used interchangeably.
award Text An award won by this person or for this creative work.
awards Text Awards won by this person or for this creative work. (legacy spelling; see singular form, award)
citation CreativeWork or Text A citation or reference to another creative work, such as another publication, web page, scholarly article, etc. NOTE: Candidate for promotion to ScholarlyArticle.
comment UserComments Comments, typically from users, on this CreativeWork.
contentLocation Place The location of the content.
contentRating Text Official rating of a piece of content—for example,'MPAA PG-13'.
contributor Organization or Person A secondary contributor to the CreativeWork.
copyrightHolder Organization or Person The party holding the legal copyright to the CreativeWork.
copyrightYear Number The year during which the claimed copyright for the CreativeWork was first asserted.
creator Organization or Person The creator/author of this CreativeWork or UserComments. This is the same as the Author property for CreativeWork.
dateCreated Date The date on which the CreativeWork was created.
dateModified Date The date on which the CreativeWork was most recently modified.
datePublished Date Date of first broadcast/publication.
discussionUrl URL A link to the page containing the comments of the CreativeWork.
editor Person Specifies the Person who edited the CreativeWork.
educationalAlignment AlignmentObject An alignment to an established educational framework.
educationalUse Text The purpose of a work in the context of education; for example, 'assignment', 'group work'.
encoding MediaObject A media object that encode this CreativeWork.
encodings MediaObject The media objects that encode this creative work (legacy spelling; see singular form, encoding).
genre Text Genre of the creative work
headline Text Headline of the article
inLanguage Text The language of the content. please use one of the language codes from the IETF BCP 47 standard.
interactionCount Text A count of a specific user interactions with this item—for example, 20 UserLikes, 5 UserComments, or 300 UserDownloads. The user interaction type should be one of the sub types of UserInteraction.
interactivityType Text The predominant mode of learning supported by the learning resource. Acceptable values are 'active', 'expositive', or 'mixed'.
isBasedOnUrl URL A resource that was used in the creation of this resource. This term can be repeated for multiple sources. For example, http://example.com/great-multiplication-intro.html
isFamilyFriendly Boolean Indicates whether this content is family friendly.
keywords Text The keywords/tags used to describe this content.
learningResourceType Text The predominant type or kind characterizing the learning resource. For example, 'presentation', 'handout'.
mentions Thing Indicates that the CreativeWork contains a reference to, but is not necessarily about a concept.
offers Offer An offer to sell this item—for example, an offer to sell a product, the DVD of a movie, or tickets to an event.
provider Organization or Person Specifies the Person or Organization that distributed the CreativeWork.
publisher Organization The publisher of the creative work.
publishingPrinciples URL Link to page describing the editorial principles of the organization primarily responsible for the creation of the CreativeWork.
review Review A review of the item.
reviews Review Review of the item (legacy spelling; see singular form, review).
sourceOrganization Organization The Organization on whose behalf the creator was working.
text Text The textual content of this CreativeWork.
thumbnailUrl URL A thumbnail image relevant to the Thing.
timeRequired Duration Approximate or typical time it takes to work with or through this learning resource for the typical intended target audience, e.g. 'P30M', 'P1H25M'.
typicalAgeRange Text The typical range of ages the content's intendedEndUser, for example '7-9', '11-'.
version Number The version of the CreativeWork embodied by a specified resource.
video VideoObject An embedded video object.
Properties from ItemList
itemListElement Text A single list item.
itemListOrder Text Type of ordering (e.g. Ascending, Descending, Unordered).
Schema Version 1.0c

Example 1

Original HTML:

<h2>Top 10 laptops</h2>
<p>1. HP Pavilion dv6-6013cl</p>
<p>2. Dell XPS 15 (Sandy Bridge)</p>
<p>3. Lenovo ThinkPad X220</p>
...


With Schema.org:
<div itemscope itemtype="http://schema.org/ItemList">
  <meta itemprop="mainContentOfPage" content="true"/>
  <h2 itemprop="name">Top 10 laptops</h2><br>
  <meta itemprop="itemListOrder" content="Descending" />
  <p>1. <span itemprop="itemListElement">HP Pavilion dv6-6013cl</span></p>
  <p>2. <span itemprop="itemListElement">Dell XPS 15 (Sandy Bridge)</span></p>
  <p>3. <span itemprop="itemListElement">Lenovo ThinkPad X220</span></p>
  ...
</div>