AggregateRating - schema.org

# schema.org

- Documentation
- Schemas
- Home

# AggregateRating

#### Thing > Intangible > Rating > AggregateRating

The average rating based on multiple ratings or reviews.
Usage: Between 500,000 and 1,000,000 domains

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

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

Properties from AggregateRating
`itemReviewed` | Thing | The item that is being reviewed/rated.
`ratingCount` | Integer | The count of total number of ratings.
`reviewCount` | Integer | The count of total number of reviews.
Properties from Rating
`bestRating` | Number or Text | The highest value allowed in this rating system. If bestRating is omitted, 5 is assumed.
`ratingValue` | Text | The rating for the content.
`worstRating` | Number or Text | The lowest value allowed in this rating system. If worstRating is omitted, 1 is assumed.
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 AggregateRating may appear as values for the following properties

Property | On Types | Description
--- | --- | ---

`aggregateRating`

Brand or
CreativeWork or
Event or
Offer or
Organization or
Place or
Product or
Service

The overall rating, based on a collection of reviews or ratings, of the item.

Examples
Example 1
Without Markup Microdata RDFa JSON-LD

    GreatFood
    4 stars - based on 250 reviews
    1901 Lemur Ave
    Sunnyvale, CA 94086
    (408) 714-1489
    <a href="http://www.greatfood.com">www.greatfood.com</a>
    Hours:
    Mon-Sat 11am - 2:30pm
    Mon-Thur 5pm - 9:30pm
    Fri-Sat 5pm - 10pm
    Categories: Middle Eastern, Mediterranean
    Price Range: $$
    Takes Reservations: Yes

    <div itemscope itemtype="http://schema.org/Restaurant">
      <span itemprop="name">GreatFood</span>
      <div itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating">
        <span itemprop="ratingValue">4</span> stars -
        based on <span itemprop="reviewCount">250</span> reviews
      </div>
      <div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
        <span itemprop="streetAddress">1901 Lemur Ave</span>
        <span itemprop="addressLocality">Sunnyvale</span>,
        <span itemprop="addressRegion">CA</span> <span itemprop="postalCode">94086</span>
      </div>
      <span itemprop="telephone">(408) 714-1489</span>
      <a itemprop="url" href="http://www.dishdash.com">www.greatfood.com</a>
      Hours:
      <meta itemprop="openingHours" content="Mo-Sa 11:00-14:30">Mon-Sat 11am - 2:30pm
      <meta itemprop="openingHours" content="Mo-Th 17:00-21:30">Mon-Thu 5pm - 9:30pm
      <meta itemprop="openingHours" content="Fr-Sa 17:00-22:00">Fri-Sat 5pm - 10:00pm
      Categories:
      <span itemprop="servesCuisine">
        Middle Eastern
      </span>,
      <span itemprop="servesCuisine">
        Mediterranean
      </span>
      Price Range: <span itemprop="priceRange">$$</span>
      Takes Reservations: Yes
    </div>

    <div vocab="http://schema.org/" typeof="Restaurant">
      <span property="name">GreatFood</span>
      <div property="aggregateRating" typeof="AggregateRating">
        <span property="ratingValue">4</span> stars -
        based on <span property="reviewCount">250</span> reviews
      </div>
      <div property="address" typeof="PostalAddress">
        <span property="streetAddress">1901 Lemur Ave</span>
        <span property="addressLocality">Sunnyvale</span>,
        <span property="addressRegion">CA</span> <span property="postalCode">94086</span>
      </div>
      <span property="telephone">(408) 714-1489</span>
      <a property="url" href="http://www.dishdash.com">www.greatfood.com</a>
      Hours:
      <meta property="openingHours" content="Mo-Sa 11:00-14:30">Mon-Sat 11am - 2:30pm
      <meta property="openingHours" content="Mo-Th 17:00-21:30">Mon-Thu 5pm - 9:30pm
      <meta property="openingHours" content="Fr-Sa 17:00-22:00">Fri-Sat 5pm - 10:00pm
      Categories:
      <span property="servesCuisine">
        Middle Eastern
      </span>,
      <span property="servesCuisine">
        Mediterranean
      </span>
      Price Range: <span property="priceRange">$$</span>
      Takes Reservations: Yes
    </div>

    <script type="application/ld+json">
    {
      "@context": "http://schema.org",
      "@type": "Restaurant",
      "address": {
        "@type": "PostalAddress",
        "addressLocality": "Sunnyvale",
        "addressRegion": "CA",
        "postalCode": "94086",
        "streetAddress": "1901 Lemur Ave"
      },
      "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": "4",
        "reviewCount": "250"
      },
      "name": "GreatFood",
      "openingHours": [
        "Mo-Sa 11:00-14:30",
        "Mo-Th 17:00-21:30",
        "Fr-Sa 17:00-22:00"
      ],
      "priceRange": "$$",
      "servesCuisine": [
        "Middle Eastern",
        "Mediterranean"
      ],
      "telephone": "(408) 714-1489",
      "url": "http://www.dishdash.com"
    }
    </script>

Example 2
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 3
Without Markup Microdata RDFa JSON-LD

    <img src="dell-30in-lcd.jpg" alt="A Dell UltraSharp monitor" />
    Dell UltraSharp 30" LCD Monitor
    87 out of 100 based on 24 user ratings
    $1250 to $1495 from 8 sellers
    Sellers:
    <a href="save-a-lot-monitors.com/dell-30.html">
      Save A Lot Monitors - $1250</a>
    <a href="jondoe-gadgets.com/dell-30.html">
      Jon Doe's Gadgets - $1350</a>
    ...

    <div itemscope itemtype="http://schema.org/Product">
      <img itemprop="image" src="dell-30in-lcd.jpg" alt="A Dell UltraSharp monitor"/>
      <span itemprop="name">Dell UltraSharp 30" LCD Monitor</span>
      <div itemprop="aggregateRating"
        itemscope itemtype="http://schema.org/AggregateRating">
        <span itemprop="ratingValue">87</span>
        out of <span itemprop="bestRating">100</span>
        based on <span itemprop="ratingCount">24</span> user ratings
      </div>
      <div itemprop="offers" itemscope itemtype="http://schema.org/AggregateOffer">
        <span itemprop="lowPrice">$1250</span>
        to <span itemprop="highPrice">$1495</span>
        from <span itemprop="offerCount">8</span> sellers
        Sellers:
        <div itemprop="offers" itemscope itemtype="http://schema.org/Offer">
            <a itemprop="url" href="save-a-lot-monitors.com/dell-30.html">
            Save A Lot Monitors - $1250</a>
        </div>
        <div itemprop="offers" itemscope itemtype="http://schema.org/Offer">
            <a itemprop="url" href="jondoe-gadgets.com/dell-30.html">
            Jon Doe's Gadgets - $1350</a>
        </div>
      </div>
      ...
    </div>

    <div vocab="http://schema.org/" typeof="Product">
      <img property="image" src="dell-30in-lcd.jpg" alt="A Dell UltraSharp monitor"/>
      <span property="name">Dell UltraSharp 30" LCD Monitor</span>
      <div property="aggregateRating"
         typeof="AggregateRating">
        <span property="ratingValue">87</span>
        out of <span property="bestRating">100</span>
        based on <span property="ratingCount">24</span> user ratings
      </div>
      <div property="offers" typeof="AggregateOffer">
        <span property="lowPrice">$1250</span>
        to <span property="highPrice">$1495</span>
        from <span property="offerCount">8</span> sellers
      Sellers:
      <div property="offers" typeof="Offer">
        <a property="url" href="save-a-lot-monitors.com/dell-30.html">
         Save A Lot Monitors - $1250</a>
      </div>
      <div property="offers" typeof="Offer">
        <a property="url" href="jondoe-gadgets.com/dell-30.html">
         Jon Doe's Gadgets - $1350</a>
      </div>
      ...
    </div>

    <script type="application/ld+json">
    {
      "@context": "http://schema.org",
      "@type": "Product",
      "aggregateRating": {
        "@type": "AggregateRating",
        "bestRating": "100",
        "ratingCount": "24",
        "ratingValue": "87"
      },
      "image": "dell-30in-lcd.jpg",
      "name": "Dell UltraSharp 30\" LCD Monitor",
      "offers": {
        "@type": "AggregateOffer",
        "highPrice": "$1495",
        "lowPrice": "$1250",
        "offerCount": "8",
        "offers": [
          {
            "@type": "Offer",
            "url": "save-a-lot-monitors.com/dell-30.html"
          },
          {
            "@type": "Offer",
            "url": "jondoe-gadgets.com/dell-30.html"
          }
        ]
      }
    }
    </script>

Example 4
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