> For the complete documentation index, see [llms.txt](https://top-100-writer.gitbook.io/top100-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://top-100-writer.gitbook.io/top100-documentation/nastroika-sbora-i-otpravki-dannykh/veb-schyotchik/razmetka-dlya-otchetov-po-media/razmetka-schema.org/microdata.md).

# Microdata

**Microdata** — это способ разметки, при котором данные передаются в стандартных элементах языка HTML.

Для разметки материала добавьте атрибут itemscope к любому тегу, в котором содержится описываемая сущность. Чтобы указать, что это за сущность, сразу после itemscope добавьте атрибут itemtype и в качестве его значения пропишите нужный класс в виде `itemtype="http://schema.org/<Имя класса>"`. Сущности также можно вкладывать друг в друга. Чтобы указать свойства сущности, используйте атрибут itemprop.

**Внимание!** Корректный сбор и отправка разметки возможны только при отсутствии вложенных сущностей.

Для корректной передачи информации следует настроить следующие сущности:

* [Тип материала](#tip-materiala) \[обязательно]
* [Идентификатор материала](#identifikator-materiala) \[обязательно]
* [Заголовок материала](#id-standartysemanticheskoimikrorazmetki-microdata-zagolovok-required) \[обязательно]
* [Дата публикации](#data-publikacii) \[обязательно]
* [Дата модификации](#data-modifikacii)
* [Url материала](#url-materiala)
* [Рубрика](#rubrika)
* [Тематика](#tematika)
* [Автор](#avtor)
* [Аннотация материала ](#annotaciya-materiala-vvodnyi-abzac)(вводный абзац)
* [Текст](#tekst)
* [Видео](#video)

Как разметить материал:

### Тип материала

Для передачи типа необходимо воспользоваться полями [schema.org/Article](https://schema.org/Article), [schema.org/NewsArticle](http://schema.org/NewsArticle), [schema.org/BlogPosting](https://schema.org/BlogPosting) или [schema.org/WebPage](https://schema.org/WebPage).

* Article — общая разметка, подходящая всем текстовым материалам;
* NewsArticle — отдельная разметка для новостей или дополнительных материалов;
* BlogPosting — разметка для статьи из блога;
* WebPage — общая разметка, подходящая к любому материалу.

**Пример:**

`<div` `itemtype="`[`http://schema.org/Article`](http://schema.org/Article)`">`\
`<h1>Крым, Турция, США. Как отдыхают футболисты</h1>`\
`<p>Летнее межсезонье в Российской Премьер-Лиге получилось мимолётным, многие команды уже вышли из отпуска и начали подготовку к новому розыгрышу. Футболисты попытались воспользоваться этой паузой максимально продуктивно. </p>`\
`</div>`

### Идентификатор материала

Для передачи идентификатора материала необходимо настроить передачу поля [identifier](https://schema.org/identifier). Идентификатор должен содержать более 3х символов.

**Пример:**

`<meta` `itemprop="identifier"` `content="entity_78686">`

### **Заголовок материала** <a href="#id-standartysemanticheskoimikrorazmetki-microdata-zagolovok-required" id="id-standartysemanticheskoimikrorazmetki-microdata-zagolovok-required"></a>

Для передачи заголовка материала необходимо настроить передачу полей [headline](https://schema.org/headline) или [alternativeHeadline](https://schema.org/alternativeHeadline).

**Пример:**

`<h1` `itemprop="headline">Стиль бохо входит в моду летом 2019</h1>`

### Дата публикации

Для передачи даты публикации необходимо использовать поле [datePublished](https://schema.org/datePublished). Разметка передается в формате [ISO 8601](https://www.iso.org/standard/40874.html).

**Пример:**

`<time itemprop="datePublished"` `datetime="2019-07-17T11:45:13+04:00">17.07.2019, 11:45</time>`

### Дата модификации

Поля [datePublished](https://schema.org/datePublished) (обязательное) и дата изменения [dateModified](https://schema.org/dateModified) (опциональное). Разметка поддерживает формат [ISO 8601](https://www.iso.org/standard/40874.html).

**Пример:**

`<meta itemprop="dateModified"` `content="2019-07-18T08:21:11+04:00">`

### Url материала

Для передачи url материала и контейнера можно использовать поле [url](https://schema.org/url)

**Пример:**

`"<link itemprop="url" href="https://www.championat.com/football/article-4522451-s-kem-sygraet-sbornaya-rossii-v-stykovyh-matchah-chm-2022-severnaya-makedoniya-vozmozhnyj-sopernik-komandy-karpina.html"></link>"`

### Рубрика

Для передачи данных по рубрикам можно использовать [breadcrumbList](https://schema.org/BreadcrumbList) или [genre](https://schema.org/genre).\
Рубрики отражают иерархическую структуру сайта. Рубрика может быть узкой и находиться внутри широкой темы. Определите несколько сущностей типа [ListItem](https://schema.org/ListItem) внутри класса, задайте им свойства [itemListElement](https://schema.org/itemListElement), которые описывают текущую и более широкие рубрики. Рубрикой данного материала будет считаться значение сущности с наибольшим position.

**Пример:**

`<p><meta itemprop="genre" content="style, fashion"/>Новый стиль моды в Москве</p>`

**Пример:**

`<ol` `itemscope=""` `itemtype="`[`http://schema.org/BreadcrumbList`](http://schema.org/BreadcrumbList)`">`\
`<li` `itemprop="itemListElement"` `itemscope=""` `itemtype="`[`http://schema.org/ListItem`](http://schema.org/ListItem)`">`\
`<a` `itemprop="item"` `href="//site.ru/fashion">`\
`<span` `itemprop="name">Мода</span></a>`\
`<meta` `itemprop="position"` `content="1">`\
`</li>`\
`<li` `itemprop="itemListElement"` `itemscope=""` `itemtype="`[`http://schema.org/ListItem`](http://schema.org/ListItem)`">`\
`<a` `itemprop="item"` `href="//site.ru/fashion/boho">`\
`<span` `itemprop="name">Стиль бохо</span></a>`\
`<meta` `itemprop="position"` `content="2">`\
`</li>`\
`<li` `itemprop="itemListElement"` `itemscope=""` `itemtype="`[`http://schema.org/ListItem`](http://schema.org/ListItem)`">`\
`<a` `itemprop="item"` `href="//site.ru/fashion/boho/woven-bags">`\
`<span` `itemprop="name">Плетеные сумки</span></a>`\
`<meta` `itemprop="position"` `content="3">`\
`</li>`\
`</ol>`

### Тематика

Для передачи тематики необходимо использовать поле [about](https://schema.org/about). Тематики отражают содержание статьи. В отличие от рубрик, количество тематик материала не ограничено. Обозначьте ее ключевыми словами или тегами.

**Пример:**

`<div` `itemprop="about">Мода</div>`\
`<div` `itemprop="about"` `itemscope=""` `itemtype="`[`https://schema.org/Thing`](https://schema.org/Thing)`">`\
`<span` `itemprop="name">Одежда</span>`\
`</div>`

### Автор

Для передачи автора можно воспользоваться полями [author](https://schema.org/author) или [person](https://schema.org/Person). Если их несколько, укажите каждого в отдельном теге.

**Пример:**

`<div` `itemprop="author">Автор статьи</div>`\
`<div` `itemprop="author"` `itemscope=""` `itemtype="`[`http://schema.org/Person`](http://schema.org/Person)`"> <span` `itemprop="name">Автор статьи</span></div>`

### Аннотация материала (вводный абзац)

Для передачи аннотации материала используется поле [abstract](https://schema.org/abstract).

**Пример:**

`<p` `itemprop="abstract"> Летнее межсезонье в Российской Премьер-Лиге получилось мимолётным, многие команды уже вышли из отпуска и начали подготовку к новому розыгрышу. Футболисты попытались воспользоваться этой паузой максимально продуктивно.</p>`

### Текст

Для передачи текста материала используется поле [articleBody](https://schema.org/articleBody). Текст статьи, должен содержать более 500 знаком и быть в единственном экземпляре на странице.

**Пример:**

`<p` `itemprop="articleBody">Летнее межсезонье в Российской Премьер-Лиге получилось мимолётным, многие команды уже вышли из отпуска и начали подготовку к новому розыгрышу. Футболисты попытались воспользоваться этой паузой максимально продуктивно.</p>`

### Видео

Для передачи видео информации используется поле [videoObject](https://schema.org/VideoObject). Минимально необходимые поля для описания видео.

| url         | [URL](http://schema.org/URL)                  | Ссылка на видеоролик.                                 |
| ----------- | --------------------------------------------- | ----------------------------------------------------- |
| name        | [Text](http://schema.org/Text)                | Название видео.                                       |
| description | [Text](http://schema.org/Text)                | Описание видео.                                       |
| duration    | [Duration](https://schema.org/Duration)       | Продолжительность видео.                              |
| thumbnail   | [ImageObject](https://schema.org/ImageObject) | Описание изображения при предварительном просмотре.   |
| uploadDate  | [Date](http://schema.org/DateTime)            | Дата загрузки видеоролика на сайт в формате ISO 8601. |

**Пример:**

| <p><code>\<div</code> <code>itemprop="video"</code> <code>itemscope itemtype="</code><a href="http://schema.org/VideoObject"><code><http://schema.org/VideoObject></code></a><code>"</code> <code>></code><br><code>\<a</code> <code>itemprop="url"</code> <code>href="</code><a href="https://www.mysite.com/view/306/"><code><https://www.mysite.com/view/306/></code></a><code>"></code><br><code>\<h1</code> <code>itemprop="name">Что такое Schema.org\</h1></code><br><code>\</a></code><br><code>\<p</code> <code>itemprop="description">Schema.org - это стандарт семантической разметки данных в сети, объявленный поисковыми системами Google, Bing и Yahoo! летом 2011 года. Цель семантической разметки — сделать интернет более понятным, структурированным и облегчить поисковым системам и специальным программам извлечение и обработку информации для удобного её представления в результатах поиска.\</p></code><br><code>\<meta</code> <code>itemprop="duration"</code> <code>content="PT6M58S"></code><br><code>\<meta</code> <code>itemprop="isFamilyFriendly"</code> <code>content="true"></code><br><code>\<p>Дата загрузки: \<span</code> <code>itemprop="uploadDate">2013-06-05T00:00:00\</span>\</p></code><br><code>\<span</code> <code>itemprop="thumbnail"</code> <code>itemscope itemtype="</code><a href="http://schema.org/ImageObject"><code><http://schema.org/ImageObject></code></a><code>"></code><br><code>\<img</code> <code>itemprop="contentUrl"</code> <code>src="</code><a href="https://www.mysite.com/images/preview/img1.jpg"><code><https://www.mysite.com/images/preview/img1.jpg></code></a><code>"></code><br><code>\<meta</code> <code>itemprop="width"</code> <code>content="250"></code><br><code>\<meta</code> <code>itemprop="height"</code> <code>content="120"></code><br><code>\</span></code><br><code>\</div></code></p> |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |