---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.1
alternate:
  - https://yandex.ru/support/webmaster/en/open-graph/intro-open-graph.md
  - https://yandex.ru/support/webmaster/ru/open-graph/intro-open-graph.md
  - href: https://yandex.ru/support/webmaster/ru/open-graph/intro-open-graph.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/support/webmaster/ru/llms.txt?revision=r22014549
    rel: describedby
keywords: open graph
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/webmaster/ru/llms.txt?revision=r22014549

# Open Graph


{% note info %}

Раздел содержит информацию [оригинального руководства](http://ogp.me/).

{% endnote %}


Стандарт Open Graph разработан социальной сетью Facebook[ *](*service). Он позволяет контролировать превью, которое формируется при публикации ссылки на сайт в социальных сетях, и передавать информацию другим интернет-сервисам.


![](../_assets/open-graph-main.png)


Разметку Open Graph используют Facebook[ *](*service), Вконтакте, Google+, Twitter, LinkedIn, Pinterest и другие сервисы. В Яндексе Open Graph используется для [передачи данных в поиск Яндекса по видео](https://yandex.ru/support/webmaster/ru/video/open-graph.md).

Поиск по видео распознает не только основные, но и многие другие метатеги, например, разные типы видео (сериалы, клипы, фильмы и т. д.), ограничения по возрасту или стране просмотра. В зависимости от выбранного типа можно также указывать дополнительные свойства объекта: название фильма, номер эпизода сериала, дату выпуска телешоу и другие. Так как для поиска Яндекса по видео нужны метатеги, которых нет в документации от Facebook[ *](*service), в сервисе используется свое расширение.

Кроме построения превью, стандарт Open Graph могут использовать разработчики приложений для публикации действий пользователей в Facebook[ *](*service). В таких публикациях можно указывать действующее лицо (пользователя), объект, действие с этим объектом и название приложения, с помощью которого это действие было произведено.

## Основные метатеги {#basic-metadata}

В стандарте Open Graph одна страница описывает только один объект — человека, компанию или продукт. Для этого объекта и указываются все данные. Чтобы передать информацию сервисам, необходимо в HTML-код (в элемент `head`) добавить следующие обязательные метатеги:

- `og:title` — название объекта.
- `og:type` — тип объекта, например, `video.movie` (фильм). Если у вас несколько объектов на странице, выберите один из них (главный). В зависимости от типа можно указать дополнительные свойства.
- `og:image` — URL изображения, описывающего объект.
- `og:url` — канонический URL объекта, который будет использован в качестве постоянного идентификатора.

```
<meta property="og:title" content="Мэрилин Монро"/>
<meta property="og:description" content="Американская киноактриса и певица"/>
<meta property="og:image" content="https://upload.wikimedia.org/wikipedia/commons/thumb/2/27/Marilyn_Monroe_-_publicity.JPG/210px-Marilyn_Monroe_-_publicity.JPG"/>
<meta property="og:type" content="profile"/>
<meta property="og:url" content= "https://ru.wikipedia.org/wiki/Мэрилин_Монро"/>
```


## Дополнительные метатеги {#optional-metadata}

- `og:audio` — URL звукового файла, который относится к описываемому объекту.
- `og:description` — краткое описание объекта.
- `og:determiner` — слово (артикль), которое должно быть перед названием объекта в предложении. Может быть указано как: `a`, `an`, `the`, `""`, `auto`. Если в значении будет указано `auto`, сервис, распознающий разметку, будет выбирать между значениями `a` и `an`. Если значение не указано, перед названием объекта артикль будет отсутствовать.
- `og:locale` — язык описания объекта в формате `язык_страна`. По умолчанию используется значение `en_US`.
- `og:locale:alternate` — массив дополнительных языков, на которых доступно описание объекта.
- `og:site_name` — название сайта, на котором размещена информация об объекте.
- `og:video` — URL видео файла, который относится к описываемому объекту.

```
<meta property="og:audio" content="http://example.com/bond/theme.mp3" />
<meta property="og:description" 
  content="Sean Connery found fame and fortune as the
           suave, sophisticated British agent, James Bond." />
<meta property="og:determiner" content="the" />
<meta property="og:locale" content="en_GB" />
<meta property="og:locale:alternate" content="fr_FR" />
<meta property="og:locale:alternate" content="es_ES" />
<meta property="og:site_name" content="IMDb" />
<meta property="og:video" content="http://example.com/bond/trailer.swf" />
```


## Структурированные метатеги {#structured-properties}

Некоторые метатеги могут иметь дополнительные (необязательные) метаданные. Такие метатеги содержат дополнительный знак `:` (двоеточие).

Например, `og:image` может содержать следующие метаданные:

- `og:image:url` — URL изображения, описывающего объект (соответствует `og:image`).
- `og:image:secure_url` — дополнительный URL, если страница открывается по протоколу HTTPS.
- `og:image:type` — MIME-тип изображения (формат изображения стандарта [MIME](https://ru.wikipedia.org/wiki/MIME)).
- `og:image:width` — ширина изображения в пикселах.
- `og:image:height` — высота изображения в пикселах.

```
<meta property="og:image" content="http://example.com/ogp.jpg" />
<meta property="og:image:secure_url" content="https://secure.example.com/ogp.jpg" />
<meta property="og:image:type" content="image/jpeg" />
<meta property="og:image:width" content="400" />
<meta property="og:image:height" content="300" />
```

`og:video` может содержать такие же метаданные, как и `og:image`. Например:

```
<meta property="og:video" content="http://example.com/movie.swf" />
<meta property="og:video:secure_url" content="https://secure.example.com/movie.swf" />
<meta property="og:video:type" content="application/x-shockwave-flash" />
<meta property="og:video:width" content="400" />
<meta property="og:video:height" content="300" />
```

`og:audio` содержит только некоторые метаданные из вышеперечисленных:

```
<meta property="og:audio" content="http://example.com/sound.mp3" />
<meta property="og:audio:secure_url" content="https://secure.example.com/sound.mp3" />
<meta property="og:audio:type" content="audio/mpeg" />
```


## Массивы {#arrays}

Если метатег может содержать несколько значений, добавьте дополнительные meta-элементы на страницу. При возникновении конфликтов будут учитываться данные, указанные в первом элементе `meta` (сверху вниз).

```
<meta property="og:image" content="http://example.com/rock.jpg" />
<meta property="og:image" content="http://example.com/rock2.jpg" />
```

Укажите структурированные метатеги после основного метатега.

```
<meta property="og:image" content="http://example.com/rock.jpg" />
<meta property="og:image:width" content="300" />
<meta property="og:image:height" content="300" />
<meta property="og:image" content="http://example.com/rock2.jpg" />
<meta property="og:image" content="http://example.com/rock3.jpg" />
<meta property="og:image:height" content="1000" />
```

где разметка означает, что на странице размещены 3 изображения: первое имеет размер 300x300, для второго изображения размер не указан, третье — 1000 пикселей в высоту.


## Объекты {#object-types}

Чтобы передать данные об объекте, необходимо указать его тип с помощью метатега `og:type`:

```
<meta property="og:type" content="website" />
```

В этом примере указан один из глобальных (общепризнанных) типов. Остальные типы указываются согласно синтаксису [CURIE](http://en.wikipedia.org/wiki/CURIE):

```
<head prefix="my_namespace: http://example.com/ns">
<meta property="og:type" content="my_namespace:my_type" />
</head>
```

Глобальные типы объектов группируются в вертикали. Каждая вертикаль имеет свое пространство имен. Значение метатега `og:type` для пространства имен всегда состоит из названия типа объекта и уточнения (`<тип объекта:уточнение>`). Это позволяет избежать путаницы с типами, которые задаются пользователем и содержат знак `:` (двоеточие).

{% cut "Музыка" %}

Значения метатега `og:type`:

**music.song**

 
:   - `music:duration` (integer >=1) — длительность песни в секундах.
    - `music:album` (music.album, массив) — название альбома.
    - `music:album:disc` (integer >=1) — номер диска.
    - `music:album:track` (integer >=1) — номер трека.
    - `music:musician` (profile, массив) — имя исполнителя.
    
    ```
    <html prefix="og: http://ogp.me/ns#
                  video: http://ogp.me/ns/music#
                  ya: http://example.com/vocabularies/" >
    <head>
    <meta property="og:type" content="music.song"/>
    <meta property="music:song" content="Favorite song"/>
    <meta property="music:duration" content="185"/><!--Длительность песни в секундах-->
    </head>
    ...
    </html>
    ```

**music.album**

 
:   - `music:song` - `music.song` - название песни.
    - `music:song:disc` (integer >=1) — номер диска (соответствует значению `music:album:disc`).
    - `music:song:track` (integer >=1) — номер трека (соответствует значению `music:album:track`).
    - `music:musician` (profile) — исполнитель песни.
    - `music:release_date` (datetime) — дата выпуска альбома.

**music.playlist**

 
:   - `music:song` — соответствует значению `music.song`, которое указано в `music.album`.
    - `music:song:disc`
    - `music:song:track`
    - `music:creator` — автор плейлиста.

**music.radio_station**

 
:   - `music:creator` — автор радио-станции.

{% endcut %}

{% cut "Видео" %}


Значения свойства `og:type`:

**video.movie**

 
:   - `video:actor` (profile, массив) — актеры.
    - `video:actor:role` (string) — роли, которые исполняют актеры.
    - `video:director` (profile, массив) — режиссер.
    - `video:writer` (profile, массив) — сценарист.
    - `video:duration` (integer >=1) — длительность фильма в секундах.
    - `video:release_date` (datetime) — дата выхода фильма в прокат.
    - `video:tag` (string, массив) — теги (слова, фразы), связанные с фильмом.
    
    ```
    <html prefix="og: http://ogp.me/ns#
                  video: http://ogp.me/ns/video#
                  ya: http://example.com/vocabularies/" >
    <head>
    <meta property="og:type" content="video.movie"/>
    <meta property="video:tag" content="webmaster"/>
    <meta property="video:duration" content="205"/><!--Длительность видео в секундах-->
    </head>
    ...
    </html>
    ```

**video.episode**

 
:   - `video:actor` — соответствует значению `video.movie`.
    - `video:actor:role`
    - `video:director`
    - `video:writer`
    - `video:duration`
    - `video:release_date`
    - `video:tag`
    - `video:series` (video.tv_show) — серия.

**video.tv_show**

 
:   ТВ-шоу. Разметка соответствует значению `video.movie`.

**video.other**

 
:   Видео, которое не относится к перечисленным категориям. Разметка соответствует значению `video.movie`.


{% endcut %}

{% cut "Другие" %}


Далее описаны объекты, которые не включены в вертикали, но поддерживаются.

Значения метатега `og:type`:

**article**

 
:   - `article:published_time` (datetime) — дата публикации статьи.
    - `article:modified_time` ( datetime) — дата последнего изменения статьи.
    - `article:expiration_time` (datetime) — дата, после которой статья считается устаревшей.
    - `article:author` (profile, массив) — автор статьи.
    - `article:section` (string) — тема (раздел), к которой относится статья (например, Технологии).
    - `article:tag` (string, массив) — теги (слова, фразы), связанные с этой статьей.

**book**

 
:   - `book:author` (profile, массив) — автор книги.
    - `book:isbn` (string) — уникальный номер книги ([ISBN](https://ru.wikipedia.org/wiki/Международный_стандартный_номер_книги)).
    - `book:release_date` (datetime) — дата публикации книги.
    - `book:tag` (string, массив) — теги (слова, фразы), связанные с этой книгой.

**profile**

 
:   - `profile:first_name` (string) — имя.
    - `profile:last_name` (string) — фамилия.
    - `profile:username` (string) — ник (имя пользователя, под которым он зарегистрирован).
    - `profile:gender` (enum) — пол (`male`, `female`).

**website**

 
:   Не имеет значений, кроме основных. Любая неразмеченная страница определяется как объект `website`.


{% endcut %}

### Типы объектов {#types-objects}


#|
||
**Тип**
|
**Описание**
|
**Примеры значений**
||
||
Boolean
|
Может принимать значения `true` или `false`, 1 или 0
|
true, false, 1, 0
||
||
DateTime
|
Временная величина. Может содержать дату (год, месяц, день) и время (часы, минуты) согласно стандарту [ISO 8601](https://ru.wikipedia.org/wiki/ISO_8601)
|
2015-07-15, 15:05
||
||
Enum
|
Состоит из ограниченного множества постоянных строковых значений
|
male, female
||
||
Float
|
64-битное число с плавающей точкой
|
1.234, -1.234, 1.2e3, -1.2e3, 7E-10
||
||
Integer
|
32-битное целое число. Может содержать все символы, которые соответствуют следующим форматам: 1234, -123
|
5, 15, 180
||
||
String
|
Последовательность символов стандарта [Unicode](https://ru.wikipedia.org/wiki/Юникод)
|
webmaster
||
||
URL
|
Все действительные URL, которые доступны по HTTP- или HTTPS-протоколу
|
http://www.example.com
||
|#


## Пример использования {#example}

Чтобы добавить информацию для формирования сниппетов, в HTML-коде страниц внутри элемента `head` укажите заголовок страницы и название сайта в свойствах `og:title` и `og:site_name`.

```xml
<head>
    <meta property="og:title" content="Файлы / Обновленный русификатор для Far Cry 4 / PlayGround.ru" />
</head>
```


![](../_assets/ogtitle.png)


```xml
<head>
    <meta property="og:site_name" content="Словари и энциклопедии на Академике" />
</head>
```


![](../_assets/ogsitename.png)



\* Сервис, запрещенный на территории РФ.



Если у вас остались вопросы:

- Напишите в чат службы поддержки — в правом нижнем углу нажмите значок ![](../_assets/logo-mes-1.svg). Чат доступен ежедневно с 8:00 до 00:00 по московскому времени.

- Заполните форму обратной связи ниже.


<div class="cut-button">

{% cut "Написать в службу поддержки" %}

<!-- source: ru/_includes/popup/id-popup/form-intro.md -->
Чтобы ваш вопрос быстрее попал к нужному специалисту, уточните тему:
<!-- endsource: ru/_includes/popup/id-popup/form-intro.md -->


{% cut "Как часто формируется разметка" %}


Разметка формируется в течение двух недель. Если Яндекс не поддерживает какой-то из видов разметки на странице или в разметке ошибки, то просто пропускает ее.


{% endcut %}

{% cut "Не нашлось подходящей разметки" %}


Робот Яндекса сможет проиндексировать информацию с сайта и без разметки, на показ страниц в поиске это не повлияет. Чтобы задать желаемое описание страницы в результатах поиска, используйте метатег [description](https://yandex.ru/support/webmaster/ru/indexing-options/description.md).


{% endcut %}

{% cut "Ошибка в валидаторе микроразметки" %}


Подробное описание возможных ошибок см. в разделе [Валидатор микроразметки](https://yandex.ru/support/webmaster/ru/yandex-indexing/validator.md).


{% cut "Не удалось исправить ошибку" %}


<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.ru/surveys/5252/?&iframe=1">
</iframe>
</div>





{% endcut %}


{% endcut %}

{% cut "Другой вопрос о партнерской программе или разметке" %}


<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.ru/surveys/5252/?&iframe=1">
</iframe>
</div>





{% endcut %}

{% endcut %}

</div>

<!-- source: ru/_includes/footer.md -->
<div width="100%" align="center" class="main-footer"> 
<br><br><br>
Также вы можете перейти на сервис 
<br><br>


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





</div>


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

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

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

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

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

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

<!-- source: ru/_includes/remove-3lvl-minitoc.md -->

<!-- endsource: ru/_includes/remove-3lvl-minitoc.md -->

<!-- source: ru/_includes/dl-indentation.md -->

<!-- endsource: ru/_includes/dl-indentation.md -->

[*service]: Сервис, запрещенный на территории РФ.