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, Romantic avenue, 21
Telephone: +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">
   <span class="category">Cafe</span>
   <span class="fn org">Chamomile</span>
 <div class="adr">
   <span class="locality">Sunny city</span>,
   <span class="street-address">Romantic avenue, 21</span>
 <div>Telephone: <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>

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

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.


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.


  • 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 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.


Publishing information marked up in hCard on your website doesn't guarantee that the information 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.