---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.2
alternate:
  - https://yandex.com/support/webmaster/en/schema-org/what-is-schema-org.md
  - https://yandex.com/support/webmaster/tr/schema-org/what-is-schema-org.md
  - href: en/schema-org/what-is-schema-org.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
keywords: schema org
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/webmaster/en/llms.txt



# Schema.org

`Schema.org` is a standard for semantic data markup on the web, announced by Google, Bing, and Yahoo! search engines in summer 2011.

Semantic markup serves to make the internet more comprehensible and structured, enabling search engines and dedicated software to easily extract and process information for user-friendly display in search results.

You can mark up documents using special attributes that are entered directly in HTML code. You don't need to create any separate export files.

## Why use microformats {#about}

You can use semantic markup to improve your site's snippets in the search results.

Compare the snippets in search results for a Yandex Dictionaries partner site's page: one snippet with semantic markup and one without.

- The site without semantic markup.
- The site that uses semantic markup.

The standard provides a set of classes describing a variety of entities and their properties. There are already several hundred of them. The standard is constantly being improved, with adding new properties and extending the existing ones.

For the standard description, go to the [documentation](http://schema.org/docs/documents.html) section on the Schema.org [official site](http://schema.org/).


## Basic markup principles {#principles}

Every `Schema.org` markup is carried out in two steps:

1. First you wrap a certain type in a container and specify the markup schema:
    
    ```xml
    <div itemscope itemtype="http://schema.org/Organization" >
    ...
    </div>
    ```
    
1. Then you enter the appropriate values for each markup attribute:
    
    ```xml
    <span itemprop="streetAddress">Lev Tolstoy, 16</span>
    ```
    

### Document without markup

 
> ```xml
> <div>
>   <span>Yandex</span>
>   Contact details:
>   <div>
>     Address: 16 Leo Tolstoy St.,
>     119021,
>     Moscow,
>   </div>
>   Phone number: +7 495 739-70-00, 
>   Fax number: +7 495 739-70-70,
>   Email: pr@yandex-team.ru
> </div>
> ```

### Document with `Schema.org` markup

 
> ```xml
> <div itemscope itemtype="http://schema.org/Organization">
>   <span itemprop="name">Yandex</span>
>   Contact details:
>   <div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
>     Address:
>     <span itemprop="streetAddress">16 Leo Tolstoy St.</span>
>     <span itemprop="postalCode"> 119021</span>
>     <span itemprop="addressLocality">Moscow</span>,
>   </div>
>   Phone number:<span itemprop="telephone">+7 495 73-70-00</span>,
>   Fax number:<span itemprop="faxNumber">+7 495 739-70-70</span>,
>   Email: <span itemprop="email">pr@yandex-team.ru</span>
> </div>
> ```


## Getting started with Schema.org {#start}

- [Introduction to Schema.org](https://yandex.com/support/webmaster/en/schema-org/intro-schema-org.md)
- [Article on the official site](http://schema.org/docs/gs.html)


## Tools for using semantic markup {#tools}

- [Structured data validator](http://webmaster.yandex.com/microtest.xml) in Yandex Webmaster.
- For popular CMS, plug-ins for implementing micro-markup can be developed. You can check whether there is a plugin for your site in the CMS or in the description of the site building platform.


## How Yandex uses the markup data {#yandex-use}

Semantic markup is used by various Yandex services:

- [Products and prices markup](https://yandex.com/support/webmaster/en/supported-schemas/goods-prices.md) helps Yandex search generate special snippets for pages with this kind of markup.
    
- [Software information markup](https://yandex.com/support/webmaster/en/supported-schemas/software.md) (applications, computer programs, games, and so on) helps the search generate special snippets for pages with this kind of markup.
    
- [Recipe markup](https://yandex.com/support/webmaster/en/supported-schemas/recipe.md) helps the search generate special snippets for pages with this kind of markup.
- [Film description markup](https://yandex.com/support/webmaster/en/supported-schemas/movie-description.md) helps the search generate special snippets for pages with this kind of markup.
- [Markup of questions and answers for mobile search](https://yandex.com/support/webmaster/en/supported-schemas/q-and-a.md) helps Search highlight the best answer and generate special snippets for pages with this kind of markup.
- [Marking up student research and similar works](https://yandex.com/support/webmaster/en/supported-schemas/essay.md) helps the search generate special snippets for pages with this kind of markup.
- [Marking up organization information and its address](https://yandex.com/support/webmaster/en/supported-schemas/address-organization.md) helps Yandex Business and Yandex search generate special snippets for pages with this kind of markup.
- [Marking up information about images](https://yandex.com/support/images/schema-org.html) helps enhance their appearance in Yandex Images.
- [Marking up information about videos](https://yandex.com/support/video/partners/partner-program.html) helps improve the way they are displayed.


{% note info %}

Information marked up according to the `Schema.org` standard becomes publicly available and can be extracted or used by any service.

{% endnote %}


<div class="cut-button">

{% cut "Contact support" %}

<!-- source: en/_includes/popup/id-popup/form-intro.md -->
Tell us what your question is about so we can direct you to the right specialist:
<!-- endsource: en/_includes/popup/id-popup/form-intro.md -->

{% list tabs radio %}

- 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](https://yandex.com/support/webmaster/en/indexing-options/description.md) meta tag.



- Error in the structured data validator


  For a detailed description of errors, see [Structured data validator](https://yandex.com/support/webmaster/en/yandex-indexing/validator.md).


  {% cut "Error could not be fixed" %}




  <div style="padding: 15px;
        margin: 10px 0;
        background: #FFFFFF;
        border-radius: 10px;
        border: 1px solid var(--yc-color-line-generic);">
  <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.com/surveys/5252/?&iframe=1&lang=en">
  </iframe>
  </div>



  {% endcut %}


  {% cut "Other questions about the partner program or markup" %}




  <div style="padding: 15px;
        margin: 10px 0;
        background: #FFFFFF;
        border-radius: 10px;
        border: 1px solid var(--yc-color-line-generic);">
  <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.com/surveys/5252/?&iframe=1&lang=en">
  </iframe>
  </div>



  {% endcut %}

{% endlist %}

{% endcut %}

</div>


<!-- source: en/_includes/footer.md -->
<div width="100%" align="center" class="main-footer"> 
<br><br><br>
You can also go to 
<br><br>




[![](../_assets/logo/logo-pic.svg)](https://webmaster.yandex.com/) [![](../_assets/logo/logo-en.svg)](https://webmaster.yandex.com/)



</div>


<!-- source: en/_includes/styles/footer-style.md -->

<!-- endsource: en/_includes/styles/footer-style.md -->
<!-- endsource: en/_includes/footer.md -->

<!-- source: en/_includes/cut-button-style.md -->

<!-- endsource: en/_includes/cut-button-style.md -->

<!-- source: en/_includes/border-style.md -->

<!-- endsource: en/_includes/border-style.md -->