Note: You are viewing the development version of Schema.org. See how we work for more details.

aggregateRating

A Schema.org Property
Thing > Property :: aggregateRating
The overall rating, based on a collection of reviews or ratings, of the item.

Values expected to be one of these types

Used on these types

Examples

Example 1
Copied
No Markup Microdata RDFa JSON-LD Structure
Example notes or example HTML without markup.
  1. GreatFood
  2. 4 stars - based on 250 reviews
  3. 1901 Lemur Ave
  4. Sunnyvale, CA 94086
  5. (408) 714-1489
  6. <a href="http://www.greatfood.com">www.greatfood.com</a>

  8. Hours:
  9. Mon-Sat 11am - 2:30pm
  10. Mon-Thur 5pm - 9:30pm
  11. Fri-Sat 5pm - 10pm

  13. Categories: Middle Eastern, Mediterranean
  14. Price Range: $$
  15. Takes Reservations: Yes
Example encoded as Microdata embedded in HTML.
  1. <div itemscope itemtype="https://schema.org/Restaurant">
  2.   <span itemprop="name">GreatFood</span>

  4.   <div itemprop="aggregateRating" itemscope itemtype="https://schema.org/AggregateRating">
  5.     <span itemprop="ratingValue">4</span> stars -
  6.     based on <span itemprop="reviewCount">250</span> reviews
  7.   </div>

  9.   <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
  10.     <span itemprop="streetAddress">1901 Lemur Ave</span>
  11.     <span itemprop="addressLocality">Sunnyvale</span>,
  12.     <span itemprop="addressRegion">CA</span> <span itemprop="postalCode">94086</span>
  13.   </div>
  14.   <span itemprop="telephone">(408) 714-1489</span>
  15.   <a itemprop="url" href="http://www.greatfood.com">www.greatfood.com</a>

  17.   Hours:
  18.   <meta itemprop="openingHours" content="Mo-Sa 11:00-14:30">Mon-Sat 11am - 2:30pm
  19.   <meta itemprop="openingHours" content="Mo-Th 17:00-21:30">Mon-Thu 5pm - 9:30pm
  20.   <meta itemprop="openingHours" content="Fr-Sa 17:00-22:00">Fri-Sat 5pm - 10:00pm

  22.   Categories:
  23.   <span itemprop="servesCuisine">
  24.     Middle Eastern
  25.   </span>,
  26.   <span itemprop="servesCuisine">
  27.     Mediterranean
  28.   </span>

  30.   Price Range: <span itemprop="priceRange">$$</span>
  31.   Takes Reservations: Yes
  32. </div>
Example encoded as RDFa embedded in HTML.
  1. <div vocab="https://schema.org/" typeof="Restaurant">
  2.   <span property="name">GreatFood</span>

  4.   <div property="aggregateRating" typeof="AggregateRating">
  5.     <span property="ratingValue">4</span> stars -
  6.     based on <span property="reviewCount">250</span> reviews
  7.   </div>

  9.   <div property="address" typeof="PostalAddress">
  10.     <span property="streetAddress">1901 Lemur Ave</span>
  11.     <span property="addressLocality">Sunnyvale</span>,
  12.     <span property="addressRegion">CA</span> <span property="postalCode">94086</span>
  13.   </div>
  14.   <span property="telephone">(408) 714-1489</span>
  15.   <a property="url" href="http://www.greatfood.com">www.greatfood.com</a>

  17.   Hours:
  18.   <meta property="openingHours" content="Mo-Sa 11:00-14:30">Mon-Sat 11am - 2:30pm
  19.   <meta property="openingHours" content="Mo-Th 17:00-21:30">Mon-Thu 5pm - 9:30pm
  20.   <meta property="openingHours" content="Fr-Sa 17:00-22:00">Fri-Sat 5pm - 10:00pm

  22.   Categories:
  23.   <span property="servesCuisine">
  24.     Middle Eastern
  25.   </span>,
  26.   <span property="servesCuisine">
  27.     Mediterranean
  28.   </span>

  30.   Price Range: <span property="priceRange">$$</span>
  31.   Takes Reservations: Yes
  32. </div>
Example encoded as JSON-LD in a HTML script tag.
  1. <script type="application/ld+json">
  2. {
  3.   "@context": "https://schema.org",
  4.   "@type": "Restaurant",
  5.   "address": {
  6.     "@type": "PostalAddress",
  7.     "addressLocality": "Sunnyvale",
  8.     "addressRegion": "CA",
  9.     "postalCode": "94086",
  10.     "streetAddress": "1901 Lemur Ave"
  11.   },
  12.   "aggregateRating": {
  13.     "@type": "AggregateRating",
  14.     "ratingValue": "4",
  15.     "reviewCount": "250"
  16.   },
  17.   "name": "GreatFood",
  18.   "openingHours": [
  19.     "Mo-Sa 11:00-14:30",
  20.     "Mo-Th 17:00-21:30",
  21.     "Fr-Sa 17:00-22:00"
  22.   ],
  23.   "priceRange": "$$",
  24.   "servesCuisine": [
  25.     "Middle Eastern",
  26.     "Mediterranean"
  27.   ],
  28.   "telephone": "(408) 714-1489",
  29.   "url": "http://www.greatfood.com"
  30. }
  31. </script>
Structured representation of the JSON-LD example.
Example 2
Copied
No Markup Microdata RDFa JSON-LD Structure
Example notes or example HTML without markup.
  1. Kenmore White 17" Microwave
  2. <img src="kenmore-microwave-17in.jpg" alt='Kenmore 17" Microwave' />
  3. Rated 3.5/5 based on 11 customer reviews

  5. $55.00
  6. In stock

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

  12. Customer reviews:

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

  18.  Value purchase - by Lucas, March 25, 2011
  19. 4/5 stars
  20. Great microwave for the price. It is small and fits in my apartment.
  21. ...
Example encoded as Microdata embedded in HTML.
  1. <div itemscope itemtype="https://schema.org/Product">
  2.   <span itemprop="name">Kenmore White 17" Microwave</span>
  3.   <img itemprop="image" src="kenmore-microwave-17in.jpg" alt='Kenmore 17" Microwave' />
  4.   <div itemprop="aggregateRating"
  5.     itemscope itemtype="https://schema.org/AggregateRating">
  6.    Rated <span itemprop="ratingValue">3.5</span>/5
  7.    based on <span itemprop="reviewCount">11</span> customer reviews
  8.   </div>

  10.   <div itemprop="offers" itemscope itemtype="https://schema.org/Offer">

  12.     <!--price is 1000, a number, with locale-specific thousands separator
  13.     and decimal mark, and the $ character is marked up with the
  14.     machine-readable code "USD" -->
  15.     <span itemprop="priceCurrency" content="USD">$</span><span
  16.           itemprop="price" content="1000.00">1,000.00</span>

  18.     <link itemprop="availability" href="https://schema.org/InStock" />In stock
  19.   </div>

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

  26.   Customer reviews:

  28.   <div itemprop="review" itemscope itemtype="https://schema.org/Review">
  29.     <span itemprop="name">Not a happy camper</span> -
  30.     by <span itemprop="author">Ellie</span>,
  31.     <meta itemprop="datePublished" content="2011-04-01">April 1, 2011
  32.     <div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
  33.       <meta itemprop="worstRating" content = "1">
  34.       <span itemprop="ratingValue">1</span>/
  35.       <span itemprop="bestRating">5</span>stars
  36.     </div>
  37.     <span itemprop="reviewBody">The lamp burned out and now I have to replace
  38.     it. </span>
  39.   </div>

  41.   <div itemprop="review" itemscope itemtype="https://schema.org/Review">
  42.     <span itemprop="name">Value purchase</span> -
  43.     by <span itemprop="author">Lucas</span>,
  44.     <meta itemprop="datePublished" content="2011-03-25">March 25, 2011
  45.     <div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
  46.       <meta itemprop="worstRating" content = "1"/>
  47.       <span itemprop="ratingValue">4</span>/
  48.       <span itemprop="bestRating">5</span>stars
  49.     </div>
  50.     <span itemprop="reviewBody">Great microwave for the price. It is small and
  51.     fits in my apartment.</span>
  52.   </div>
  53.   ...
  54. </div>
Example encoded as RDFa embedded in HTML.
  1. <div vocab="https://schema.org/" typeof="Product">
  2.   <span property="name">Kenmore White 17" Microwave</span>
  3.   <img property="image" src="kenmore-microwave-17in.jpg" alt='Kenmore 17" Microwave' />
  4.   <div property="aggregateRating"
  5.      typeof="AggregateRating">
  6.    Rated <span property="ratingValue">3.5</span>/5
  7.    based on <span property="reviewCount">11</span> customer reviews
  8.   </div>

  10.   <div property="offers" typeof="Offer">
  11.     <!--price is 1000, a number, with locale-specific thousands separator
  12.         and decimal mark, and the $ character is marked up with the
  13.         machine-readable code "USD" -->
  14.     <span property="priceCurrency" content="USD">$</span><span
  15.       property="price" content="1000.00">1,000.00</span>
  16.     <link property="availability" href="https://schema.org/InStock" />In stock
  17.   </div>

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

  24.   Customer reviews:

  26.   <div property="review" typeof="Review">
  27.     <span property="name">Not a happy camper</span> -
  28.     by <span property="author">Ellie</span>,
  29.     <meta property="datePublished" content="2011-04-01">April 1, 2011
  30.     <div property="reviewRating" typeof="Rating">
  31.       <meta property="worstRating" content = "1">
  32.       <span property="ratingValue">1</span>/
  33.       <span property="bestRating">5</span>stars
  34.     </div>
  35.     <span property="reviewBody">The lamp burned out and now I have to replace
  36.     it. </span>
  37.   </div>

  39.   <div property="review" typeof="Review">
  40.     <span property="name">Value purchase</span> -
  41.     by <span property="author">Lucas</span>,
  42.     <meta property="datePublished" content="2011-03-25">March 25, 2011
  43.     <div property="reviewRating" typeof="Rating">
  44.       <meta property="worstRating" content = "1"/>
  45.       <span property="ratingValue">4</span>/
  46.       <span property="bestRating">5</span>stars
  47.     </div>
  48.     <span property="reviewBody">Great microwave for the price. It is small and
  49.     fits in my apartment.</span>
  50.   </div>
  51.   ...
  52. </div>
Example encoded as JSON-LD in a HTML script tag.
  1. <script type="application/ld+json">
  2. {
  3.   "@context": "https://schema.org",
  4.   "@type": "Product",
  5.   "aggregateRating": {
  6.     "@type": "AggregateRating",
  7.     "ratingValue": "3.5",
  8.     "reviewCount": "11"
  9.   },
  10.   "description": "0.7 cubic feet countertop microwave. Has six preset cooking categories and convenience features like Add-A-Minute and Child Lock.",
  11.   "name": "Kenmore White 17\" Microwave",
  12.   "image": "kenmore-microwave-17in.jpg",
  13.   "offers": {
  14.     "@type": "Offer",
  15.     "availability": "https://schema.org/InStock",
  16.     "price": "55.00",
  17.     "priceCurrency": "USD"
  18.   },
  19.   "review": [
  20.     {
  21.       "@type": "Review",
  22.       "author": "Ellie",
  23.       "datePublished": "2011-04-01",
  24.       "reviewBody": "The lamp burned out and now I have to replace it.",
  25.       "name": "Not a happy camper",
  26.       "reviewRating": {
  27.         "@type": "Rating",
  28.         "bestRating": "5",
  29.         "ratingValue": "1",
  30.         "worstRating": "1"
  31.       }
  32.     },
  33.     {
  34.       "@type": "Review",
  35.       "author": "Lucas",
  36.       "datePublished": "2011-03-25",
  37.       "reviewBody": "Great microwave for the price. It is small and fits in my apartment.",
  38.       "name": "Value purchase",
  39.       "reviewRating": {
  40.         "@type": "Rating",
  41.         "bestRating": "5",
  42.         "ratingValue": "4",
  43.         "worstRating": "1"
  44.       }
  45.     }
  46.   ]
  47. }
  48. </script>
Structured representation of the JSON-LD example.
Example 3
Copied
No Markup Microdata RDFa JSON-LD Structure
Example notes or example HTML without markup.
  1. <img src="dell-30in-lcd.jpg" alt="A Dell UltraSharp monitor" />
  2. Dell UltraSharp 30" LCD Monitor

  4. 87 out of 100 based on 24 user ratings

  6. $1250 to $1495 from 8 sellers

  8. Sellers:
  9. <a href="save-a-lot-monitors.com/dell-30.html">
  10.   Save A Lot Monitors - $1250</a>
  11. <a href="jondoe-gadgets.com/dell-30.html">
  12.   Jon Doe's Gadgets - $1350</a>
  13. ...
Example encoded as Microdata embedded in HTML.
  1. <div itemscope itemtype="https://schema.org/Product">
  2.   <img itemprop="image" src="dell-30in-lcd.jpg" alt="A Dell UltraSharp monitor"/>
  3.   <span itemprop="name">Dell UltraSharp 30" LCD Monitor</span>

  5.   <div itemprop="aggregateRating"
  6.     itemscope itemtype="https://schema.org/AggregateRating">
  7.     <span itemprop="ratingValue">87</span>
  8.     out of <span itemprop="bestRating">100</span>
  9.     based on <span itemprop="ratingCount">24</span> user ratings
  10.   </div>

  12.   <div itemprop="offers" itemscope itemtype="https://schema.org/AggregateOffer">
  13.     <meta itemprop="priceCurrency" content="USD" />
  14.     <span itemprop="lowPrice" content="1250">$1250</span>
  15.     to <span itemprop="highPrice" content="1495">$1495</span>
  16.     from <span itemprop="offerCount">8</span> sellers

  18.     Sellers:
  19.     <div itemprop="offers" itemscope itemtype="https://schema.org/Offer">
  20.         <a itemprop="url" href="save-a-lot-monitors.com/dell-30.html">
  21.         Save A Lot Monitors - $1250</a>
  22.     </div>
  23.     <div itemprop="offers" itemscope itemtype="https://schema.org/Offer">
  24.         <a itemprop="url" href="jondoe-gadgets.com/dell-30.html">
  25.         Jon Doe's Gadgets - $1350</a>
  26.     </div>
  27.   </div>
  28.   ...
  29. </div>
Example encoded as RDFa embedded in HTML.
  1. <div vocab="https://schema.org/" typeof="Product">
  2.     <img property="image" src="dell-30in-lcd.jpg" alt="A Dell UltraSharp monitor"> <span property="name">Dell UltraSharp 30" LCD Monitor</span>
  3.     <div property="aggregateRating" typeof="AggregateRating">
  4.         <span property="ratingValue">87</span> out of
  5.         <span property="bestRating">100</span> based on
  6.         <span property="ratingCount">24</span> user ratings
  7.     </div>
  8.     <div property="offers" typeof="AggregateOffer">
  9.         <meta property="priceCurrency" content="USD" />
  10.         <span property="lowPrice" content="1250">$1250</span> to
  11.         <span property="highPrice" content="1495">$1495</span> from
  12.         <span property="offerCount">8</span> sellers Sellers:
  13.         <div property="offers" typeof="Offer">
  14.             <a property="url" href="save-a-lot-monitors.com/dell-30.html">Save A Lot Monitors - $1250</a>
  15.         </div>
  16.         <div property="offers" typeof="Offer">
  17.             <a property="url" href="jondoe-gadgets.com/dell-30.html">Jon Doe's Gadgets - $1350</a>
  18.         </div>
  19.         ...
  20.     </div>
  21. </div>
Example encoded as JSON-LD in a HTML script tag.
  1. <script type="application/ld+json">
  2. {
  3.   "@context": "https://schema.org",
  4.   "@type": "Product",
  5.   "aggregateRating": {
  6.     "@type": "AggregateRating",
  7.     "bestRating": "100",
  8.     "ratingCount": "24",
  9.     "ratingValue": "87"
  10.   },
  11.   "image": "dell-30in-lcd.jpg",
  12.   "name": "Dell UltraSharp 30\" LCD Monitor",
  13.   "offers": {
  14.     "@type": "AggregateOffer",
  15.     "priceCurrency": "USD",
  16.     "highPrice": "1495",
  17.     "lowPrice": "1250",
  18.     "offerCount": "8",
  19.     "offers": [
  20.       {
  21.         "@type": "Offer",
  22.         "url": "save-a-lot-monitors.com/dell-30.html"
  23.       },
  24.       {
  25.         "@type": "Offer",
  26.         "url": "jondoe-gadgets.com/dell-30.html"
  27.       }
  28.     ]
  29.   }
  30. }
  31. </script>
Structured representation of the JSON-LD example.