Review Microdata

Sam Marsden
Sam Marsden

On 12th July 2018 • 5 min read

Following on from product markup, review markup like itemReviewed schema can be applied to a variety of entities such as local businesses, products, films and books etc. When search engines detect review markup they may decide to show this in their search results in a variety of ways, such as a review snippet enhancing a search result or as part of a Knowledge Card as pictured here:

Review rich snippet

 

An Example of itemReviewed Schema

To provide search engines with review markup using microdata, you can use the following basic syntax:

<div itemscope itemtype=”https://schema.org/Review”>
<div itemprop=”itemReviewed” itemscope itemtype=”https://schema.org/Restaurant”>
<img itemprop=”image” src=”seafood-restaurant.jpg” alt=”Catcher in the Rye”/>
<span itemprop=”name”>Legal Seafood</span>
</div>
<span itemprop=”reviewRating” itemscope itemtype=”https://schema.org/Rating”>
<span itemprop=”ratingValue”>4</span<
</span> stars –
<b>”<span itemprop=”name”>A good seafood place.</span>”
<span itemprop=”author” itemscope itemtype=”https://schema.org/Person”>
<span itemprop=”name”>Bob Smith</span>
</span>
<span itemprop=”reviewBody”>The seafood is great.</span>
<div itemprop=”publisher” itemscope itemtype=”https://schema.org/Organization”>
<meta itemprop=”name” content=”Washington Times”>
</div>
</div>

To provide the same information in JSON-LD you can refer to the following example:

<script type=”application/ld+json”>
{
“@context”: “https://schema.org/”,
“@type”: “Review”,
“itemReviewed”: {
“@type”: “Restaurant”,
“image”: “https://www.example.com/seafood-restaurant.jpg”,
“name”: “Legal Seafood”
},
“reviewRating”: {
“@type”: “Rating”,
“ratingValue”: “4”
},
“name”: “A good seafood place.”,
“author”: {
“@type”: “Person”,
“name”: “Bob Smith”
},
“reviewBody”: “The seafood is great.”,
“publisher”: {
“@type”: “Organization”,
“name”: “Washington Times”
}
}
</script>

Both of these examples provide details such as: the item type (e.g. restaurant), name, image, rating value, author and organization.

If you want to provide details about a review rating, you will need to use the following syntax using microdata:

<span itemscope itemtype=”https://schema.org/Review”>
<span itemprop=”itemReviewed” itemscope itemtype=”https://schema.org/Thing”>
<span itemprop=”name”>Super Book</span>
</span>
<span itemprop=”author” itemscope itemtype=”https://schema.org/Person”>
<span itemprop=”name”>Joe</span>
</span>
<span itemprop=”reviewRating” itemscope itemtype=”https://schema.org/Rating”>
Rating:
<span itemprop=”ratingValue”>7</span> out of
<span itemprop=”bestRating”>10</span>
</span>
<span itemprop=”publisher” itemscope itemtype=”https://schema.org/Organization”>
<meta itemprop=”name” content=”Washington Times”>
</span>
</span>

Alternatively, providing the same markup using JSON-LD would look like this:

<script type=”application/ld+json”>
{
“@context”: “https://schema.org/”,
“@type”: “Review”,
“itemReviewed”: {
“@type”: “Thing”,
“name”: “Super Book”
},
“author”: {
“@type”: “Person”,
“name”: “Joe”
},
“reviewRating”: {
“@type”: “Rating”,
“ratingValue”: “7”,
“bestRating”: “10”
},
“publisher”: {
“@type”: “Organization”,
“name”: “Washington Times”
}
}
</script>

The above provides review rating details including: item type, name, author type, author name, rating value, best possible rating, publisher type and publisher name.

 

Review markup considerations

When applying review markup it is important to note that:

Next: Other Microdata

Author

Sam Marsden
Sam Marsden

Sam Marsden is DeepCrawl's SEO & Content Manager. Sam speaks regularly at marketing conferences, like SMX and BrightonSEO, and is a contributor to industry publications such as Search Engine Journal and State of Digital.

Choose a better way to grow

With tools that will help you realize your website’s true potential, and support to help you get there, growing your enterprise business online has never been so simple.

Book a Demo