Thing > CreativeWork > Review
A review of an item - for example, a restaurant, movie, or store.Property | Expected Type | Description |
---|---|---|
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>