Review - health-lifesci.schema.org

# health-lifesci.schema.org

- Documentation
- Schemas
- Home

core + health-lifesci (Health and Lifesciences Extension): terms relating to healthcare, medicine and the life sciences.

# 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

Property | Expected Type | Description
--- | --- | ---
[more...]

- Leave public feedback on this term 💬
- Check for open issues.
- 'Review' is mentioned in layer: core
- 'Review' is mentioned in extension layer: pending

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` | 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 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` | Organization or Person | A secondary contributor to the CreativeWork or Event.
`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. 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. See also availableLanguage. 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` | CreativeWork or Product or 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. 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` | Organization or Person | The person or organization who produced the work (e.g. music album, movie, tv/radio series etc.).
`provider` | Organization or Person | 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` | Text or URL | 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` | Organization or Person | Organization or person who adapts a creative work to different languages, regional differences and technical requirements of a target market, or that translates during some event.
`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` | ImageObject or URL | 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
CreativeWork or
Event or
Offer or
Organization or
Place or
Product or
Service

A review of the item. Supersedes reviews.

#### Available properties in extensions

- For CreativeWork in the bib extension: publisherImprint, translationOfWork, workTranslation
- For CreativeWork in the pending extension: accessMode, accessModeSufficient, accessibilitySummary, contentReferenceTime

#### More specific Types available in extensions

- ClaimReview

Examples
Example 1
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>

Example 2
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">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: $<span property="price">6.99</span>
      <meta property="priceCurrency" content="USD" />
      <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 3.0