Reviews

Annotations for reviews allow Bing to associate 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 contain the following review:

Contoso Café

Chef Dan Jump seems to be on top of his game!

Contoso Café provides a variety of comfort food made to order with the freshest ingredients.

Reviewed by: Jennifer Anderson on November 10, 2010.

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

Marking It Up

Reviews will contain one or more of the following attributes.

 

Item property

Microdata

Microformat

RDFa

Description

Item reviewed

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

The title/summary of the review.

Comments

description

description

description

The review comments.

Review author

reviewer

reviewer

reviewer

The review author.

Review date

dtreviewed

dtreviewed

dtreviewed

The date of the review.

Rating

rating

rating

rating

A numerical representation of the item’s quality.

Bing recommends the use of the ISO 8601 standard for dates, times and durations.

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: A review for Contoso Café.

<div itemscope itemtype="http://data-vocabulary.org/Review"> <div itemprop="itemreviewed"><strong>Contoso Café</strong></div> <div itemprop="summary">Chef Dan Jump seems to be on top of his game!</div> <div itemprop="description"> Contoso Café provides a variety of comfort food made to order with the freshest ingredients. </div> <div> <strong>Reviewed by:</strong> <span itemprop="reviewer">Jennifer Anderson</span> on <span itemprop="dtreviewed" datetime="2010-11-10">November 10, 2010</span>. </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>

Breaking It Down

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

Note the use of the datetime attribute to convey a machine-readable version of the review date to search engines, while displaying a human-friendly version on the page.

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)

Example: A review for Contoso Café.

<div class="hreview"> <div class="item"> <div class="fn"><strong>Contoso Café</strong></div> </div> <div class="summary">Chef Dan Jump seems to be on top of his game!</div> <div class="description"> Contoso Café provides a variety of comfort food made to order with the freshest ingredients. </div> <div> <strong>Reviewed by:</strong> <span class="reviewer">Jennifer Anderson</span> on <span class="dtreviewed">November 10, 2010<span class="value-title" title="2010-11-10"></span></span>. </div> <div class="rating"> <strong>Rating:</strong> ★★★☆☆ (<span class="value">3</span> out of <span class="best">5</span>) </div> </div>

Breaking It Down

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

We use an empty span element to convey a machine-readable version of the review date to search engines, while displaying a human-friendly version on the page.

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: A review for Contoso Café.

<div xmlns:v="http://rdf.data-vocabulary.org/#" typeof="v:Review"> <div property="v:itemreviewed"><strong>Contoso Café</strong></div> <div property="v:summary">Chef Dan Jump seems to be on top of his game!</div> <div property="v:description"> Contoso Café provides a variety of comfort food made to order with the freshest ingredients. </div> <div> <strong>Reviewed by:</strong> <span property="v:reviewer">Jennifer Anderson</span> on <span property="v:dtreviewed" content="2010-11-10">November 10, 2010</span>. </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>

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"). We then use a combination of block and inline elements to annotate the review.

Note the use of the content attribute to convey a machine-readable version of the review date to search engines, while displaying a human-friendly version on the page.

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>