hCard microformat

hCard is a popular open format that is widely used all over the world to publish contact information in a structured form.

hCard is based on standard elements of (X)HTML. The concept of hCard is very simple: you mark up the data already residing on your site in a special way so that it can be understood not only by people, but by search robots as well.

For example, take the following text:

Cafe Camomile
Sunny city. Romantic avenue, 21
Phone: +7 (890) 123-45-67
We are open daily from 11:00 to 24:00

This text can be easily transformed into a business card in hCard format. The card's HTML code may look as follows:

<div class="vcard">
 <div>
   <span class="category">Cafe</span>
   <span class="fn org">Camomile</span>
 </div>
 <div class="adr">
   <span class="locality">Sunny city</span>,
   <span class="street-address">Romantic avenue, 21</span>
 </div>
 <div>Phone: <span class="tel">+7 (890) 123-45-67</span></div>
 <div>We are open <span class="workhours">daily from 11:00 to 24:00</span>
   <span class="url">
     <span class="value-title" title="http://www.romashka-cafe.ru"> </span>
   </span>
 </div>
</div>

The official specification for hCard format is published at http://microformats.org/wiki/hcard.

A version in Russian (may slightly differ from the original) is located at http://microformats.org/wiki/hcard-ru.

How Yandex works with hCard

You can use hCard to inform Yandex about the address, telephone number, and other information about your organization simply by publishing an hCard on your site.

Note.

By publishing a text marked up in hCard format, you make the data available not only to Yandex but also to other applications that collect data on the web.

hCard markup is processed at the same time when your site is indexed by the Yandex search robot. Extracted address data is added to Yandex Business Directory and displayed in various Yandex services.

For example:

  • On the search results page under the site description.

  • On the map when searching for an organization.

The data is checked for accuracy. The data isn't included in Yandex Business Directory if the organization doesn't exist or if you provided a wrong address. When added to the Business Directory, the organization is assigned one or more categories depending on the scope of its activities.

Please note that contact information is always tied to the official site of the company and is only displayed alongside the site.

Note.

Publishing information marked up in hCard on your site doesn't guarantee that the information will be added to Yandex Business Directory or another Yandex service. Yandex reserves the right, at its sole discretion, to utilize or not utilize the hCard markup information or any part of it with any of its services, either separately or jointly with information obtained from other sources. Cards are processed only for four countries: Russia, Ukraine, Belarus, and Kazakhstan.

Read more about hCard elements handled by Yandex.

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.