Markup processing rules

To add contact information, use the Site geography → Addresses and organizations form in Yandex.Webmaster. Submitting contact information through the form is the same as marking up the site pages. Data sent through the Yandex.Webmaster form is added to Yandex.Business and displayed in various Yandex services.

Yandex processes cards according to the rules defined in the format specification.

Data structure requirements

The classes provided by hCard format can be combined with other CSS classes. For example, the class attribute of the card's root element can contain, in addition to the vcard class name, any set of non-hCard class names:

<div class="vcard footer">...</div>

The same applies to the elements that are card properties.

There are restrictions on combining hCard classes. It isn't allowed to mark avcard class element with another hCard class. Also, it isn't recommended to nest properties. For example, you can't place a tel class element inside an adr class element (this structure might be processed incorrectly). An exception is made for nested properties that are explicitly listed in the standard, such as country-name, region, locality, street-address, extended-address, postal-code properties nested in the adr property; latitude and longitude properties nested in the geo property, and so on.

Rules for extracting values

In most cases, the property value is the text contained within the element of the corresponding class and visible to the users. Some elements are exceptions:

  • The <abbr> element with the title attribute: the value of the property is the value of this attribute. Example:
    <abbr class="tel" title="+ 7 (890) 123-45-67">123-45-67</abbr>
    The browser displays the value “123-45-67”, while the value of the tel property is “+ 7 (890) 123-45-67”.
  • The <a> element with the href attribute for the URL properties (that is, properties that have a URL for the value, namely url, email, logo and photo): the value of the href attribute is assigned as the value of the property.

    Example:

    <a class="fn org url" href="http://www.cafe.com">Cafe Chamomile</a>

    The url property value is “http://www.cafe.com”.

    For the fn and org properties that are not URL properties, the value is “Camomile Cafe”.

  • The <img> element with the src attribute for URL properties: the value of the src attribute is assigned as the value of the property.

  • For the <img> element with the alt attribute for non-URL properties: the value of the alt attribute is assigned as the value of the property.

    Example:
    <img class="logo fn org" alt="Кафе Ромашка" src="images/logo.gif">
    The value of the logo property is “images/logo.gif”, and the value of the fn and org properties is “Camomile Cafe”.

In addition, you can mark part of the element's visible text as the value of the property. To do this, add a nested element with the value class to this element.

Example:
<div class="tel">Inquiry office: <span class="value">+7 (890) 123-45-67</span></div>
In this case, the value of the tel property is “+7 (890) 123-45-67”.

To make a property value invisible to site visitors (display a different text on the page instead of it, or nothing at all), use a nested element of the value-titleclass with the titleattribute. In this case, the value of the title attribute is assigned as the value of the property.

Examples:

<div class="tel">
  <span class="value-title" title="+7 (890) 123-45-67">123-45-67</span>
</div>
<div class="tel">
  <span class="value-title" title="+7 (890) 123-45-67"> </span> 123-45-67
</div>

In both cases, the value of the tel property is “+7 (890) 123-45-67”. The second option lets you avoid showing a pop-up with the“actual” value of the property whenever the user mouses over the phone number.

Tell us what your question is about so we can direct you to the right specialist:

The markup is created within two weeks. If Yandex doesn't support any of the markup types on the page or the markup is incorrect, it skips it.

The Yandex robot will be able to index the site information even without markup, and it doesn't affect displaying pages in the search results. To set the desired page description in the search results, use the Description meta tag.

For a detailed description of errors, see Structured data validator.


This feedback form is intended for questions about Yandex partner programs and markup. If you are in doubt whether you should use a particular partner program provided by other services (not Yandex), we can't comment on how it influences your site's state in the search.