Reviews of organizations

To have reviews of organizations from your site displayed in Yandex.Maps, you need to participate in the partner program. Mark up the relevant pages according to theschema.org/Review rules so that the search robot could detect the reviews on your site.

Supported fields

The properties of the Review schema that are processed by Yandex are described below. The Schema.org data type that the property value should correspond to is indicated in parentheses.

Properties supported by Yandex but missing in the standard schema are in bold.

  • name (Text) — The review title.

  • url (URL) — Permanent link to the review. Mandatory attribute.

  • mobileUrl — Permanent link to the mobile version of the review page. If you use a mobile version of the page with the list of reviews, provide a link to the review marked with an anchor. If the partner doesn't have a mobile version or the field is not provided, the full text of the review will appear in Yandex mobile applications.

  • reviewsurl (URL) — URL of the page that contains other reviews of similar objects. One review may include several reviewsurl elements for comparative reviews or for different groups of reviews. For example, a restaurant review may include two different reviewsurl elements: one link can forward to a list of all reviews about this restaurant, and the other to a list of reviews about all restaurants available on the site.

    Pages with addresses listed in reviewsurl fields can get improved snippets in the search results.

  • reviewBody (Text) — Full text of the review.

  • datePublished (Date) — Review publication date.

  • dateVisited (Date) — Date of the visit on which the review is based.

  • author (Person) — Information about the review author.

    • name (Text) — Name of the author.

    • officialWebPage (URL) — The author's official site.

    • url (URL) — The link to the author's page on the site where the review is published.

  • pro(Text) — A brief description of the organization's advantages. We recommend that you mark every individual plus with the pro property:

    <ul>
      <li itemprop="pro">Bright, spacious dining area.</li>
      <li itemprop="pro">Extensive wine selection.</li>
    </ul>
  • contra (Text) — A brief description of the organization's negative sides. We recommend that you mark every individual minus with the contra property:

    <ul>
      <li itemprop="contra">Dirty and crowded dining area.</li>
      <li itemprop="contra">Wine of dubious quality.</li>
    </ul>
  • reviewRating (Rating) — The rating the author gave to the organization.

    • ratingValue (Text) — The rating value.

    • worstRating (Number or Text) — The minimum value of the rating. If no value is provided, the minimum rating is assumed to be 1.

    • bestRating (Number или Text) — The maximum value of the rating. If no value is provided, the maximum rating is assumed to be 5.

  • tag (Rating) — The rating of a certain feature of the organization. It should be rated in the same way as the general rating in the rating field. Specify the rated feature in the ratingTarget field.

    • ratingValue (Text) — Numeric rating value.

    • ratingTarget (Text or URL) — The rated organization's feature. To correctly mark the rating of a feature, include a link to the corresponding XML document in the page code. We recommend using the <link> tag for this:

      <link itemprop="ratingTarget" href="https://webmaster.yandex.ru/vocabularies/ReviewBusiness/Location.xml"/>

      Supported features of organizations (with a link to the corresponding XML document included in the name of each feature):

      • Cuisine — Cuisine.

      • Service — Service level.

      • Interior — Interior.

      • Value-for-money — Value for money.

      • Hall — Hall.

      • Movie-choice — The choice of movies.

      • Accommodation — The quality of rooms.

      • Location — Locaton.

      • Drinks — Drinks.

      • Equipment — Level of equipment.

      • Pool-size — The size of pool.

      • Water-quality — The quality of water.

      • Workmanship — The quality of work.

      • Price-level — The level of prices.

      • Music — Music.

      • Cleanliness — How clean it is.
      • Bea_comfort — Comfort of the room.
      • Internet — Quality of the internet connection.

      For example, the rating of a restaurant's location can be marked up as follows:

      <p itemprop="tag" itemscope itemtype="http://schema.org/Rating">
        <link itemprop="ratingTarget" href="https://webmaster.yandex.ru/vocabularies/ReviewBusiness/Location.xml">
         Difficult to access. For the location:
        <span itemprop="ratingValue">2</span> out of <span itemprop="bestRating">5</span>
      </p>
    • worstRating (Number or Text) — The minimum value of the rating. If no value is provided, the minimum rating is assumed to be equal to that of the reviewRating property.

    • bestRating (Number или Text) — The maximum value of the rating. If no value is provided, the maximum rating is assumed to be equal to that of the reviewRating property.

  • itemReviewed (Organization or Place) — The description of the reviewed organization.

    You can specify the organization type in the itemtype attribute.

    In the sample markup, the organization type is a hotel:

    <div itemprop="itemReviewed" itemscope itemtype="http://schema.org/Hotel">
    ...
    </div>
    • name (Text) — The organization name.

    • address (PostalAddress) — Postal address of the organization.

      • addressCountry (Country) — Country, for example, Russia. You can also specify the standard two-letter code.

      • addressLocality (Text) — City, town or village (for example, Moscow).

      • streetAddress (Text) — The address within the specified city, town or village (for example, <span itemprop="streetAddress">16 Lva Tolstovo</span>

      • addressRegion (Text) — Region, for example, Moscow Oblast.

      • postalCode (Text) — Postal code, for example, 119021.

    • officialWebPage (URL) — The organization's official site.

    • url (URL) — The link to the organization's page on the site that published the review.

    • email (Text) — The organization's email address.

    • geo (GeoCoordinates) — The organization's geographic coordinates.

    • telephone (Text) — The organization's phone number.

    • openingHours (Duration) — The organization's opening hours. Specified in the ISO 8601 format. First list the business days of the week followed by the opening hours on these days.

      • Days are shortened to two letters: Mo, Tu, We, Th, Fr, Sa, Su

      • Time is shown in the 24-hour format. For example, 15:00.

      • Example of markup:
        <time itemprop="openingHours" datetime="Tu,Th 16:00−20:00">Tuesdays and Thursdays from 4 to 8 pm</time>
      • If the company works 24 hours a day, 7 days a week, it can be shown as follows:
        <time itemprop="openingHours" datetime="Mo-Su">Monday to Sunday, 24 hours</time>
    • photograph (Photograph) — The photo of the premises or the building.

    • image (URL) — The link to the organization's logo.

Example of markup

<div itemscope itemtype="http://schema.org/Review">
  <h2 itemprop="name"><a href="http://example.com/review?10231" itemprop="url">Russian cuisine in exile</a></h2>
  <div>Review by <span itemprop="author" itemscope itemtype="http://schema.org/Person">
    <span itemprop="name">
      <a itemprop="url" href="http://example.com/users/vasya">Vasya Pupkin</a>
    </span>
  </span>
    <meta itemprop="datePublished" content="2012-07-15" />
    15 July, 2012.
  </div>
  <div itemprop="reviewRating" itemscope itemtype="http://schema.org/Rating">
    <meta itemprop="worstRating" content="0"/>
    <p>Rating: <span itemprop="ratingValue">9</span> out of <span itemprop="bestRating">10</span>.</p>
  </div>
  <div itemprop="pro">Free parking, nice kids' room and attentive wait staff.</div>
  <div itemprop="contra">Large and noisy non-smoking area.</div>
  <div itemprop="reviewBody">
    <p>The food was ready relatively quickly and the drinks arrived almost immediately.
    Excellent service, but empty dishes weren't cleared right away.</p>
    <p>I recommend the Russian food, especially the soups.</p>
  </div>
  <div>The author visited this location on <meta itemprop="dateVisited" content="2012-07-10">10 July, 2012.</div>
  <div>Rating of restaurant characteristics:
    <ul>
      <li itemprop="tag" itemscope itemtype="http://schema.org/Rating">
        <link itemprop="ratingTarget" href="https://webmaster.yandex.ru/vocabularies/ReviewBusiness/Cuisine.xml">
        Food: <span itemprop="ratingValue">5</span> out of <span itemprop="bestRating">5</span>;
      </li>
      <li itemprop="tag" itemscope itemtype="http://schema.org/Rating">
        <link itemprop="ratingTarget" href="https://webmaster.yandex.ru/vocabularies/ReviewBusiness/Hall.xml">
        Hall: <span itemprop="ratingValue">3</span> out of <span itemprop="bestRating">5</span>;
      </li>
    </ul>
  </div>
  <div itemprop="itemReviewed" itemscope itemtype="http://schema.org/Hotel">
    <h3>Information about the restaurant</h3>
    <p>Name: <span itemprop="name">Abroad</span></p>
    <p itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">Address:
      <span itemprop="addressLocality">Moscow</span>, <span itemprop="streetAddress">Tverskaya, 7</span>.
    </p>
    <p>Phone: <span itemprop="telephone">123-45-12</span>.</p>
    <p>Website: <a itemprop="url" href="http://zagranica.ru">http://zagranica.ru</a></p>
    <p>Email:
      <a itemprop="email" href="mailto:hostess@zagranica.ru">hostess@zagranica.ru</a>
    </p>
  </div>
</div>