Reviews (aggregated)

Aggregated review data is information about a number of reviews such as the average rating and the total number of votes used to compute that aggregate. Aggregated review data enables Bing to associate high-level review content with an item and to provide our users with a more complete impression of the listed product, service, or location.

For example, your website may have the following content:

Contoso hot dog

Rating: ★★★☆☆ (3 out of 5)

Total votes: 150 (35 reviews)

Marking It Up

Aggregated reviews will contain one or more of the following attributes.

 

Item property

Microdata

Microformat

RDFa

Description

Item review

itemreviewed

item

itemreviewed

Required. Item being reviewed. In microformats, this can refer to the name of an embedded fn item property.

Summary

summary

summary

summary

A summary of the aggregated reviews.

Photograph

photo

photo

photo

A photo representing the item being reviewed.

Rating

rating

rating

rating

A numerical representation of the item’s quality.

Total Votes

votes

votes

votes

The total number of votes being aggregated.

Total reviews

count

count

count

The total number of reviews being aggregated.

Within the rating item property, Bing supports the following optional sub-properties for all supported annotation formats:

  • best: the upper bound of the rating scale
  • worst: the lower bound of the rating scale

Microdata

Example: Aggregated review data for the Contoso hot dog

<div itemscope itemtype="http://data-vocabulary.org/Review-aggregate"> <div itemprop="itemreviewed"><strong>Contoso hot dog</strong></div> <div itemprop="rating" itemscope itemtype="http://data-vocabulary.org/Rating"> <strong>Rating:</strong> ★★★☆☆ (<span itemprop="value">3</span> out of <span itemprop="best">5</span>) </div> <div> <strong>Total votes:</strong> <span itemprop="votes">150</span> (<span itemprop="count">35</span> reviews) </div> </div>

Breaking It Down

In this example, the first line defines the item type through the vocabulary (itemtype="http://data-vocabulary.org/Review-aggregate"). We then use a combination of block and inline elements to annotate the aggregated review data.

A Note On Using Images To Represent Ratings

If you use images to represent ratings on your site, you can still annotate the rating by adding itemprop="rating" to the image tag of your rating and adding a numerical representation of the rating to the alt attribute: <img itemprop="rating" src="/Images/Rating/3Stars.png" alt="3" />

Alternatively, you can use meta elements embedded in the body (newly supported in HTML 5) to annotate your content: <meta itemprop="rating" content="3" />

Microformats (hReview-Aggregate)

Example: Aggregated review data for the Contoso hot dog

<div class="hreview-aggregate"> <div class="item"> <div class="fn"><strong>Contoso hot dog</strong></div> </div> <div class="rating"> <strong>Rating:</strong> ★★★☆☆ (<span class="value">3</span> out of <span class="best">5</span>) </div> <div> <strong>Total votes:</strong> <span class="votes">150</span> (<span class="count">35</span> reviews) </div> </div>

Breaking It Down

In this example, the hReview-Aggregate specification is used to annotate the contact information. In the first line, we define the item type (class="hreview-aggregate"). We then use a combination of block and inline elements to annotate the aggregated review data.

A Note On Using Images To Represent Ratings

If you use images to represent ratings on your site, you can still annotate the rating by adding class="rating" to the image tag of your rating and adding a numerical representation of the rating to the alt attribute: <img class="rating" src="/Images/Rating/3Stars.png" alt="3" />

Alternatively, you can use an empty span element to annotate your content: <div class="rating"> <span class="value-title" title="3"></span></div>

RDFa

Example: Aggregated review data for the Contoso hot dog

<div xmlns:v="http://rdf.data-vocabulary.org/#" typeof="v:Review-aggregate"> <div property="v:itemreviewed"><strong>Contoso hot dog</strong></div> <div rel="v:rating"> <div typeof="v:Rating"> <strong>Rating:</strong> ★★★☆☆ (<span property="v:value">3</span> out of <span property="v:best">5</span>) </div> </div> <div> <strong>Total votes:</strong> <span property="v:votes">150</span> (<span property="v:count">35</span> reviews) </div> </div>

Breaking It Down

In this example, the first line declares the namespace (xmlns:v="http://rdf.data-vocabulary.org/#") followed by the item type declaration (typeof="v:Review-aggregate"). We then use a combination of block and inline elements to annotate the aggregated review data.

A Note On Using Images To Represent Ratings

If you use images to represent ratings on your site, you can still annotate the rating by adding property="rating" to the image tag of your rating and adding a numerical representation of the rating to the alt attribute: <img property="rating" src="/Images/Rating/3Stars.png" alt="3" />

Alternatively, you can use an empty span element to annotate your content: <span property="v:rating" content="3"></span>