Review

Thing > CreativeWork > Review

A review of an item - for example, of a restaurant, movie, or store.

Usage: Between 250,000 and 500,000 domains

[more...]

Property	Expected Type	Description
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.
Properties from CreativeWork
`about`	Thing	The subject matter of the content.
`accessibilityAPI`	Text	Indicates that the resource is compatible with the referenced accessibility API (WebSchemas wiki lists possible values).
`accessibilityControl`	Text	Identifies input methods that are sufficient to fully control the described resource (WebSchemas wiki lists possible values).
`accessibilityFeature`	Text	Content features of the resource, such as accessible media, alternatives and supported enhancements for accessibility (WebSchemas wiki lists possible values).
`accessibilityHazard`	Text	A characteristic of the described resource that is physiologically dangerous to some users. Related to WCAG 2.0 guideline 2.3 (WebSchemas wiki lists possible values).
`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	A media object that encodes this CreativeWork. This property is a synonym for encoding.
`audience`	Audience	An intended audience, i.e. a group for whom something was created. Supersedes serviceAudience.
`audio`	AudioObject	An embedded audio object.
`author`	Person or Organization	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 or for this item. Supersedes awards.
`character`	Person	Fictional person connected with a creative work.
`citation`	CreativeWork or Text	A citation or reference to another creative work, such as another publication, web page, scholarly article, etc.
`comment`	Comment	Comments, typically from users.
`commentCount`	Integer	The number of comments this CreativeWork (e.g. Article, Question or Answer) has received. This is most applicable to works published in Web sites with commenting system; additional comments may exist elsewhere.
`contentLocation`	Place	The location depicted or described in the content. For example, the location in a photograph or painting.
`contentRating`	Text	Official rating of a piece of content—for example,'MPAA PG-13'.
`contributor`	Person or Organization	A secondary contributor to the CreativeWork.
`copyrightHolder`	Person or Organization	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`	Person or Organization	The creator/author of this CreativeWork. This is the same as the Author property for CreativeWork.
`dateCreated`	Date or DateTime	The date on which the CreativeWork was created or the item was added to a DataFeed.
`dateModified`	Date or DateTime	The date on which the CreativeWork was most recently modified or when the item's entry was modified within a DataFeed.
`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 encodes this CreativeWork. This property is a synonym for associatedMedia. Supersedes encodings.
`exampleOfWork`	CreativeWork	A creative work that this work is an example/instance/realization/derivation of. Inverse property: workExample.
`fileFormat`	Text	Media type (aka MIME format, see IANA site) of the content e.g. application/zip of a SoftwareApplication binary. In cases where a CreativeWork has several media type representations, 'encoding' can be used to indicate each MediaObject alongside particular fileFormat information.
`genre`	Text	Genre of the creative work or group.
`hasPart`	CreativeWork	Indicates a CreativeWork that is (in some sense) a part of this CreativeWork. Inverse property: isPartOf.
`headline`	Text	Headline of the article.
`inLanguage`	Language or Text	The language of the content or performance or used in an action. Please use one of the language codes from the IETF BCP 47 standard. Supersedes language.
`interactionStatistic`	InteractionCounter	The number of interactions for the CreativeWork using the WebSite or SoftwareApplication. The most specific child type of InteractionCounter should be used. Supersedes interactionCount.
`interactivityType`	Text	The predominant mode of learning supported by the learning resource. Acceptable values are 'active', 'expositive', or 'mixed'.
`isBasedOn`	URL or Product or CreativeWork	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. Supersedes isBasedOnUrl.
`isFamilyFriendly`	Boolean	Indicates whether this content is family friendly.
`isPartOf`	CreativeWork	Indicates a CreativeWork that this CreativeWork is (in some sense) part of. Inverse property: hasPart.
`keywords`	Text	Keywords or tags used to describe this content. Multiple entries in a keywords list are typically delimited by commas.
`learningResourceType`	Text	The predominant type or kind characterizing the learning resource. For example, 'presentation', 'handout'.
`license`	CreativeWork or URL	A license document that applies to this content, typically indicated by URL.
`locationCreated`	Place	The location where the CreativeWork was created, which may not be the same as the location depicted in the CreativeWork.
`mainEntity`	Thing	Indicates the primary entity described in some page or other CreativeWork. Inverse property: mainEntityOfPage.
`mentions`	Thing	Indicates that the CreativeWork contains a reference to, but is not necessarily about a concept.
`offers`	Offer	An offer to provide this item—for example, an offer to sell a product, rent the DVD of a movie, perform a service, or give away tickets to an event.
`position`	Integer or Text	The position of an item in a series or sequence of items.
`producer`	Person or Organization	The person or organization who produced the work (e.g. music album, movie, tv/radio series etc.).
`provider`	Person or Organization	The service provider, service operator, or service performer; the goods producer. Another party (a seller) may offer those services or goods on behalf of the provider. A provider may also serve as the seller. Supersedes carrier.
`publication`	PublicationEvent	A publication event associated with the item.
`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.
`recordedAt`	Event	The Event where the CreativeWork was recorded. The CreativeWork may capture all or part of the event. Inverse property: recordedIn.
`releasedEvent`	PublicationEvent	The place and time the release was issued, expressed as a PublicationEvent.
`review`	Review	A review of the item. Supersedes reviews.
`schemaVersion`	URL or Text	Indicates (by URL or string) a particular version of a schema used in some CreativeWork. For example, a document could declare a schemaVersion using an URL such as http://schema.org/version/2.0/ if precise indication of schema version was required by some application.
`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'.
`translator`	Person or Organization	Organization or person who adapts a creative work to different languages, regional differences and technical requirements of a target market.
`typicalAgeRange`	Text	The typical expected age range, e.g. '7-9', '11-'.
`version`	Number	The version of the CreativeWork embodied by a specified resource.
`video`	VideoObject	An embedded video object.
`workExample`	CreativeWork	Example/instance/realization/derivation of the concept of this creative work. eg. The paperback edition, first edition, or eBook. Inverse property: exampleOfWork.
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.
`alternateName`	Text	An alias for the item.
`description`	Text	A description of the item.
`disambiguatingDescription`	Text	A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation.
`image`	URL or ImageObject	An image of the item. This can be a URL or a fully described ImageObject.
`mainEntityOfPage`	CreativeWork or URL	Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details. Inverse property: mainEntity.
`name`	Text	The name of the item.
`potentialAction`	Action	Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
`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.

Instances of Review may appear as values for the following properties

Property	On Types	Description
`resultReview`	ReviewAction	A sub property of result. The review that resulted in the performing of the action.
`review`	Brand or Offer or Product or Place or CreativeWork or Service or Event or Organization	A review of the item. Supersedes reviews.

Examples

Without Markup Microdata RDFa JSON-LD

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

<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">
    <!--price is 1000, a number, with locale-specific thousands separator
    and decimal mark, and the $ character is marked up with the
    machine-readable code "USD" -->
    <span itemprop="priceCurrency" content="USD">$</span><span
          itemprop="price" content="1000.00">1,000.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>

<div vocab="http://schema.org/" typeof="Product">
  <span property="name">Kenmore White 17" Microwave</span>
  <img src="kenmore-microwave-17in.jpg" alt='Kenmore 17" Microwave' />
  <div property="aggregateRating"
     typeof="AggregateRating">
   Rated <span property="ratingValue">3.5</span>/5
   based on <span property="reviewCount">11</span> customer reviews
  </div>
  <div property="offers" typeof="Offer">
    <!--price is 1000, a number, with locale-specific thousands separator
        and decimal mark, and the $ character is marked up with the
        machine-readable code "USD" -->
    <span property="priceCurrency" content="USD">$</span><span
      property="price" content="1000.00">1,000.00</span>
    <link property="availability" href="http://schema.org/InStock" />In stock
  </div>
  Product description:
  <span property="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 property="review" typeof="Review">
    <span property="name">Not a happy camper</span> -
    by <span property="author">Ellie</span>,
    <meta property="datePublished" content="2011-04-01">April 1, 2011
    <div property="reviewRating" typeof="Rating">
      <meta property="worstRating" content = "1">
      <span property="ratingValue">1</span>/
      <span property="bestRating">5</span>stars
    </div>
    <span property="description">The lamp burned out and now I have to replace
    it. </span>
  </div>
  <div property="review" typeof="Review">
    <span property="name">Value purchase</span> -
    by <span property="author">Lucas</span>,
    <meta property="datePublished" content="2011-03-25">March 25, 2011
    <div property="reviewRating" typeof="Rating">
      <meta property="worstRating" content = "1"/>
      <span property="ratingValue">4</span>/
      <span property="bestRating">5</span>stars
    </div>
    <span property="description">Great microwave for the price. It is small and
    fits in my apartment.</span>
  </div>
  ...
</div>

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "Product",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "3.5",
    "reviewCount": "11"
  },
  "description": "0.7 cubic feet countertop microwave. Has six preset cooking categories and convenience features like Add-A-Minute and Child Lock.",
  "name": "Kenmore White 17\" Microwave",
  "offers": {
    "@type": "Offer",
    "availability": "http://schema.org/InStock",
    "price": "55.00",
    "priceCurrency": "USD"
  },
  "review": [
    {
      "@type": "Review",
      "author": "Ellie",
      "datePublished": "2011-04-01",
      "description": "The lamp burned out and now I have to replace it.",
      "name": "Not a happy camper",
      "reviewRating": {
        "@type": "Rating",
        "bestRating": "5",
        "ratingValue": "1",
        "worstRating": "1"
      }
    },
    {
      "@type": "Review",
      "author": "Lucas",
      "datePublished": "2011-03-25",
      "description": "Great microwave for the price. It is small and fits in my apartment.",
      "name": "Value purchase",
      "reviewRating": {
        "@type": "Rating",
        "bestRating": "5",
        "ratingValue": "4",
        "worstRating": "1"
      }
    }
  ]
}
</script>

Without Markup Microdata RDFa JSON-LD

<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"
  alt="cover art: red horse, city in background"/>
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.

<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 itemprop="mainEntity" itemscope itemtype="http://schema.org/Book">
<img itemprop="image" src="catcher-in-the-rye-book-cover.jpg"
     alt="cover art: red horse, city in background"/>
<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" content="6.99">$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>

<body vocab="http://schema.org/" typeof="WebPage">
...
<div property="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 property="mainEntity" typeof="Book">
<img property="image" src="catcher-in-the-rye-book-cover.jpg"
    alt="cover art: red horse, city in background"/>
<span property="name">The Catcher in the Rye</span> -
 <link property="bookFormat" href="http://schema.org/Paperback">Mass Market Paperback
by <a property="author" href="/author/jd_salinger.html">J.D. Salinger</a>
<div property="aggregateRating" typeof="AggregateRating">
  <span property="ratingValue">4</span> stars -
  <span property="reviewCount">3077</span> reviews
</div>
<div property="offers" typeof="Offer">
  Price: <meta property="priceCurrency" content="USD" />$<meta property="price" content="6.99" />6.99  
  <link property="availability" href="http://schema.org/InStock">In Stock
</div>
Product details
<span property="numberOfPages">224</span> pages
Publisher: <span property="publisher">Little, Brown, and Company</span> -
 <meta property="datePublished" content="1991-05-01">May 1, 1991
Language: <span property="inLanguage">English</span>
ISBN-10: <span property="isbn">0316769487</span>
Reviews:
<div property="review" typeof="Review">
  <span property="reviewRating">5</span> stars -
  <b>"<span property="name">A masterpiece of literature</span>"</b>
  by <span property="author">John Doe</span>,
  Written on <meta property="datePublished" content="2006-05-04">May 4, 2006
  <span property="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 property="review" typeof="Review">
  <span property="reviewRating">4</span> stars -
  <b>"<span property="name">A good read.</span>" </b>
  by <span property="author">Bob Smith</span>,
  Written on <meta property="datePublished" content="2006-06-15">June 15, 2006
  <span property="reviewBody">Catcher in the Rye is a fun book. It's a good book to read.</span>
</div>
</div>
...
</body>

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "WebPage",
  "breadcrumb": "Books > Literature & Fiction > Classics",
  "mainEntity":{
	  "@type": "Book",
	  "author": "/author/jd_salinger.html",
	  "bookFormat": "http://schema.org/Paperback",
	  "datePublished": "1991-05-01",
	  "image": "catcher-in-the-rye-book-cover.jpg",
	  "inLanguage": "English",
	  "isbn": "0316769487",
	  "name": "The Catcher in the Rye",
	  "numberOfPages": "224",
	  "offers": {
	    "@type": "Offer",
	    "availability": "http://schema.org/InStock",
	    "price": "6.99",
	    "priceCurrency": "USD"
	  },
	  "publisher": "Little, Brown, and Company",
	  "aggregateRating": {
	    "@type": "AggregateRating",
	    "ratingValue": "4",
	    "reviewCount": "3077"
	  },
	  "review": [
	    {
	      "@type": "Review",
	      "author": "John Doe",
	      "datePublished": "2006-05-04",
	      "name": "A masterpiece of literature",
	      "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.",
	      "reviewRating": {
            "@type": "Rating",
            "ratingValue": "5"
           }
	    },
	    {
	      "@type": "Review",
	      "author": "Bob Smith",
	      "datePublished": "2006-06-15",
	      "name": "A good read.",
	      "reviewBody": "Catcher in the Rye is a fun book. It's a good book to read.",
	      "reviewRating": "4"
	    }
	  ]
  	}
}
</script>

Schema Version 2.2

meta.schema.org

Review

Thing > CreativeWork > Review