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 website 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,  21 Romantic Avenue, Telephone: +7 (890) 123-45-67
Open daily from 11:00 to 24:00

It is rather easy to transform this text 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">Camomile</span>
  <div class="adr">
    <span class="locality">Sunny City</span>, <span class="street-address"> 21 Romantic Avenue</span>
  <div>Telephone: <span class="tel">+7 (890) 123-45-67</span></div>
    <span class="workhours">daily from 11:00 to 24:00</span>
 <span class="url">
     <span class="value-title" title="http://www.camomile-cafe.com"/>

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

How Yandex works with hCard

Using hCard, you can tell Yandex the address, telephone number and other information about your organization simply by publishing an hCard on your website.


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

hCard markup is processed simultaneously when your website is indexed by the Yandex search robot. Extracted address data is added to the Organizational registry and then displayed in various Yandex services.

For example:

  • on the search results page under the site description:

  • on a map when searching for businesses:

The data is checked for accuracy. The data will not be included in the registry if its corresponding organization does not exist or if the wrong address was specified. When added to the registry, the organization will be assigned one or more categories depending on the scope of its activities.

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


Publishing information marked up in hCard format on your website does not guarantee that the information will be added to the Organizational registry or any other 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.

To find out how Yandex processes hCard elements, read here.