Introduction - Version 4

Google Merchant Review Feeds allow content providers to provide merchant reviews to Google Shopping. This guide explains how to properly format your merchant review feeds using the Version 4 schema.

The following definitions help describe a feed:

Merchant
A merchant is an XML definition that describes a single merchant. Each merchant should have basic information about the business, including the merchant's name and URL. Each merchant has a set of reviews.
XML file
Your merchants are included in a properly-formatted XML file. A single XML file should include multiple merchants.
Feed
A feed is one or more XML files.

Note that your provision of a feed does not guarantee that your content will be included in Google Shopping.

Simple sample feed

The XML sample below is for one file in a merchant review feed and contains no more than the required and recommended elements that you need to include in your feed. This example is a subset of the complete sample feed.

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://schemas.google.com/merchant_reviews/4.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://schemas.google.com/merchant_reviews/4.0 http://www.google.com/shopping/reviews/schema/merchant/4.0/merchant_reviews.xsd">
  <author>
    <name>Merchant Reviews Inc.</name>
    <email>contact@example.com</email>
  </author>
  <merchant id="27390">
    <merchant_info>
      <name>Example Pet Store</name>
      <merchant_url>http://www.examplepetstore.com</merchant_url>
    </merchant_info>
    <review id="15636801">
      <review_url type="singleton">http://www.example.com/reviews/examplepetstore.com/15636801</review_url>
      <reviewer>Jane</reviewer>
      <reviewer_type>user</reviewer_type>
      <review_date>2010-07-12T07:55:06Z</review_date>
      <content>My order arrived on time and I got a great price.</content>
      <ratings>
        <overall min="1" max="10">9</overall>
      </ratings>
    </review>
  </merchant>
</feed>