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:

Chamomile Cafe
Sunny City, 21 Romantic Avenue,
Phone: +7 (890) 123-45-67
Open daily from 11:00 a.m. to 12:00 a.m.

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">Chamomile</span>
   <span class="fn org">Cafe</span>
 </div>
 <div class="adr">
   <span class="locality">Sunny City</span>,
   <span class="street-address">21 Romantic Avenue,</span>
 </div>
 <div>Phone: <span class="tel">+7 (890) 123-45-67</span></div>
 <div>Open <span class="workhours">daily from 11:00 a.m. to 12:00 a.m.</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 and displayed in various Yandex services.

The data is checked for accuracy. It won't be added to Yandex Business if the organization doesn't exist or if you provided a wrong address. When added to Yandex Business, 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 in hCard microformat on your site doesn't guarantee that it will be added to Yandex Business 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.

Contact support

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

How often is markup generated?

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

There was no suitable markup

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.

Error in the structured data validator

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

Error could not be fixed
Other questions about the partner program or markup



You can also go to