Thing > CreativeWork > Review

A review of an item - for example, a restaurant, movie, or store.
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.
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 work, i.e. the group for whom the work 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)
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.
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.
isFamilyFriendly Boolean Indicates whether this content is family friendly.
keywords Text The keywords/tags used to describe this content.
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.
version Number The version of the CreativeWork embodied by a specified resource.
video VideoObject An embedded video object.
Properties from Review
itemReviewed Thing The item that is being reviewed/rated.
reviewBody Text The actual body of the review
reviewRating Rating The rating given in this review. Note that reviews can themselves be rated. The reviewRating applies to rating given by the review. The aggregateRating property applies to the review itself, as a creative work.
Schema Draft Version 0.99

Example 1

Original HTML:

Kenmore White 17" Microwave
<img src="kenmore-microwave-17in.jpg" alt='Kenmore 17" Microwave' />
Rated 3.5/5 based on 11 customer reviews

$55.00
In stock

Product description:
0.7 cubic feet countertop microwave. Has six preset cooking categories and
 convenience features like Add-A-Minute and Child Lock.

Customer reviews:

Not a happy camper - by Ellie, April 1, 2011
1/5 stars
The lamp burned out and now I have to replace it.

 Value purchase - by Lucas, March 25, 2011
4/5 stars
Great microwave for the price. It is small and fits in my apartment.
...


With Microdata:
<div itemscope itemtype="http://schema.org/Product">
  <span itemprop="name">Kenmore White 17" Microwave</span>
  <img src="kenmore-microwave-17in.jpg" alt='Kenmore 17" Microwave' />
  <div itemprop="aggregateRating"
    itemscope itemtype="http://schema.org/AggregateRating">
   Rated <span itemprop="ratingValue">3.5</span>/5
   based on <span itemprop="reviewCount">11</span> customer reviews
  </div>

  <div itemprop="offers" itemscope itemtype="http://schema.org/Offer">
    <span itemprop="price">$55.00</span>
    <link itemprop="availability" href="http://schema.org/InStock" />In stock
  </div>

  Product description:
  <span itemprop="description">0.7 cubic feet countertop microwave.
  Has six preset cooking categories and convenience features like
  Add-A-Minute and Child Lock.</span>

  Customer reviews:

  <div itemprop="review" itemscope itemtype="http://schema.org/Review">
    <span itemprop="name">Not a happy camper</span> -
    by <span itemprop="author">Ellie</span>,
    <meta itemprop="datePublished" content="2011-04-01">April 1, 2011
    <div itemprop="reviewRating" itemscope itemtype="http://schema.org/Rating">
      <meta itemprop="worstRating" content = "1">
      <span itemprop="ratingValue">1</span>/
      <span itemprop="bestRating">5</span>stars
    </div>
    <span itemprop="description">The lamp burned out and now I have to replace
    it. </span>
  </div>

  <div itemprop="review" itemscope itemtype="http://schema.org/Review">
    <span itemprop="name">Value purchase</span> -
    by <span itemprop="author">Lucas</span>,
    <meta itemprop="datePublished" content="2011-03-25">March 25, 2011
    <div itemprop="reviewRating" itemscope itemtype="http://schema.org/Rating">
      <meta itemprop="worstRating" content = "1"/>
      <span itemprop="ratingValue">4</span>/
      <span itemprop="bestRating">5</span>stars
    </div>
    <span itemprop="description">Great microwave for the price. It is small and
    fits in my apartment.</span>
  </div>
  ...
</div>

Example 2

Original HTML:

<a href="category/books.html">Books</a> >
 <a href="category/books-literature.html">Literature & Fiction</a> >
 <a href="category/books-classics">Classics</a>

<img src="catcher-in-the-rye-book-cover.jpg" />
The Catcher in the Rye - Mass Market Paperback
by <a href="/author/jd_salinger.html">J.D. Salinger</a>
4 stars - 3077 reviews

Price: $6.99
In Stock

Product details
224 pages
Publisher: Little, Brown, and Company - May 1, 1991
Language: English
ISBN-10: 0316769487

Reviews:

5 stars - <b>"A masterpiece of literature" </b>
by John Doe. Written on May 4, 2006
I really enjoyed this book. It captures the essential challenge people face
as they try make sense of their lives and grow to adulthood.

4 stars - <b>"love it LOLOL111!" </b>
by Bob Smith, Written on June 15, 2006
Catcher in the Rye is a fun book. It's a good book to read.


With Microdata:
<body itemscope itemtype="http://schema.org/WebPage">
...
<div itemprop="breadcrumb">
  <a href="category/books.html">Books</a> >
  <a href="category/books-literature.html">Literature & Fiction</a> >
  <a href="category/books-classics">Classics</a>
</div>

<div itemscope itemtype="http://schema.org/Book">

<img itemprop="image" src="catcher-in-the-rye-book-cover.jpg" />
<span itemprop="name">The Catcher in the Rye</span> -
 <link itemprop="bookFormat" href="http://schema.org/Paperback">Mass Market Paperback
by <a itemprop="author" href="/author/jd_salinger.html">J.D. Salinger</a>

<div itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating">
  <span itemprop="ratingValue">4</span> stars -
  <span itemprop="reviewCount">3077</span> reviews
</div>

<div itemprop="offers" itemscope itemtype="http://schema.org/Offer">
  Price: <span itemprop="price">$6.99</span>
  <meta itemprop="priceCurrency" content="USD" />
  <link itemprop="availability" href="http://schema.org/InStock">In Stock
</div>

Product details
<span itemprop="numberOfPages">224</span> pages
Publisher: <span itemprop="publisher">Little, Brown, and Company</span> -
 <meta itemprop="datePublished" content="1991-05-01">May 1, 1991
Language: <span itemprop="inLanguage">English</span>
ISBN-10: <span itemprop="isbn">0316769487</span>

Reviews:

<div itemprop="review" itemscope itemtype="http://schema.org/Review">
  <span itemprop="reviewRating">5</span> stars -
  <b>"<span itemprop="name">A masterpiece of literature</span>" </b>
  by <span itemprop="author">John Doe</span>,
  Written on <meta itemprop="datePublished" content="2006-05-04">May 4, 2006
  <span itemprop="reviewBody">I really enjoyed this book. It captures the essential
  challenge people face as they try make sense of their lives and grow to adulthood.</span>
</div>

<div itemprop="review" itemscope itemtype="http://schema.org/Review">
  <span itemprop="reviewRating">4</span> stars -
  <b>"<span itemprop="name">A good read.</span>" </b>
  by <span itemprop="author">Bob Smith</span>,
  Written on <meta itemprop="datePublished" content="2006-06-15">June 15, 2006
  <span itemprop="reviewBody">Catcher in the Rye is a fun book. It's a good book to read.</span>
</div>

</div>
...
</body>