---
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/en/open-graph/intro-open-graph.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/support/webmaster/en/llms.txt?revision=r22014549
    rel: describedby
keywords: open graph
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/webmaster/en/llms.txt?revision=r22014549

# Open Graph


{% note info %}

This section contains information from the [original guide](http://ogp.me/).

{% endnote %}


The Open Graph standard is developed by the Facebook social network[ *](*service). It allows you to manage the site preview when the link to the site is posted in social networks and pass the information to other Internet services.


Open Graph markup is used by Facebook[ *](*service), VK, Google+, Twitter, LinkedIn, Pinterest and other services. Yandex uses Open Graph to [pass data to Yandex video search](https://yandex.ru/support/webmaster/en/video/open-graph.md).

In addition to basic meta tags, Yandex video search recognizes many more, such as different types of video (TV series, music videos, movies, and so on) or age and country restrictions. Depending on the chosen type, you can specify additional properties of an object: movie title, the number of the episode, TV show release date, and so on. Since Yandex video search requires meta tags not found in Facebook's[ *](*service) documentation, the service uses its own extension.

Besides building previews, app developers can use the Open Graph standard to publish user activities to Facebook[ *](*service). In such publications, you can specify the user, object, actions with this object and the application used to complete this action.

## Basic meta tags {#basic-metadata}

In Open Graph standard, a page describes only one object — a person, a company or a product. All data is specified for this object. To pass information to services, add the following mandatory meta tags to the HTML code (the `head` element):

- `og:title` — Object name.
- `og: type` — Object type, for example: `video.movie` (movie). If you have multiple objects on the page, select one of them (the main one). Depending on the type, you can specify additional properties.
- `og:image` — The URL of the image describing the object.
- `og:url` — The object's canonical URL that will be used as a permanent ID.

```
<meta property="og:title" content="Marilyn Monroe"/>
<meta property="og:description" content="American actress and singer"/>
<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://en.wikipedia.org/wiki/Marilyn_Monroe"/>
```


## Additional meta tags {#optional-metadata}

- `og:audio` — URL of the audio file corresponding to the object.
- `description` — Short object description.
- `og:determiner` — A word (article) to be put before the object name in a sentence. Can be indicated as: `a`, `an`, `the`, `""`, `auto`. If the value is specified as `auto`, the service reading the markup will choose between `a` and `an` values. If no value is specified, there will be no article before the object name.
- `og:locale` — The language of the object description set in the `language_country` format. The default value is `en_US`.
- `og:locale:alternate` — An array of additional languages in which the object description is available.
- `og:site_name` — The name of the site where the object information is placed.
- `og:video` — The URL of the video file corresponding to the object.

```
<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 meta tags {#structured-properties}

Some meta tags can have additional (optional) metadata. Such meta tags contain the additional `:` (colon) character.

For example, `og:image` may contain the following metadata:

- `og:image:url` — The URL of the image describing the object (corresponds to `og:image`).
- `og:image:secure_url` — Additional URL if the page is opened using the HTTPS protocol.
- `og:image:type` — Image MIME type (image format according to the [MIME](https://en.wikipedia.org/wiki/MIME) standard).
- `og:image:width` — Image width in pixels.
- `og:image:height` — Image height in pixels.

```
<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` can contain the same metadata as `og:image`. For example:

```
<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` contains only some of the following metadata:

```
<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 {#arrays}

If the meta tag can contain multiple values, add additional meta elements to the page. If there are conflicts, the data in the first `meta` element (top down) will be taken into account.

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

Specify structured meta tags after the main meta tag.

```
<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" />
```

where the markup means that the page contains 3 images: the first one is 300 x 300, no size is specified for the second one, and the third one is 1000 pixels high.


## Objects {#object-types}

To pass information about an object, you need to specify its type in the `og:type` meta tag:

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

In this example, one of the global (generally accepted) types is specified. Other types are specified using the [CURIE](http://en.wikipedia.org/wiki/CURIE) syntax:

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

Global object types are grouped vertically. Each vertical line has its own namespace. The value of the `og:type` meta tag for a namespace always consists of an object type and a subtype (`<object type:subtype>`). This avoids confusion with the user-defined types containing the `:` (colon) character.

{% cut "Music" %}

Values of the `og:type` meta tag:

**music.song**

 
:   - `music:duration` (integer > = 1) — Song duration in seconds.
    - `music:album` (music.album, array) — Album title.
    - `music:album:disc` (integer >= 1) — Disc number.
    - `music:album:track` (integer >= 1) — Track number.
    - `music:musician` (profile, array) — Artist name.
    
    ```
    <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"/><!--The song's duration in seconds-->
    </head>
    ...
    </html>
    ```

**music.album**

 
:   - `music:song` - `music.song` — Song title.
    - `music:song:disc` (integer >= 1) — Disc number (corresponds to the `music:album:disc` value).
    - `music:song:track` (integer >= 1) — Track number (corresponds to the `music:album:track` value).
    - `music:musician` (profile) — The song artist.
    - `music:release_date` (datetime) — Album release date.

**music.playlist**

 
:   - `music:song` — Corresponds to the `music.song` value specified in `music.album`.
    - `music:song:disc`
    - `music:song:track`
    - `music:creator` — Playlist creator.

**music.radio_station**

 
:   - `music:creator` — Radio station creator.

{% endcut %}

{% cut "Videos" %}


The values of the `og:type` property:

**video.movie**

 
:   - `video:actor` (profile, array) — Actors.
    - `video:actor:role` (string) — Roles performed by the actors.
    - `video:director` (profile, array) — Director.
    - `video:writer` (profile, array) — Script writer.
    - `video:duration` (integer >=1) — Movie duration in seconds.
    - `ovs:release_date` — Movie release date.
    - `video:tag` (string, array) — Tags (words, phrases) related to the movie.
    
    ```
    <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"/><!--The video's duration in seconds-->
    </head>
    ...
    </html>
    ```

**video.episode**

 
:   - `video:actor` — Corresponds to the `video.movie` value.
    - `video:actor:role`
    - `video:director`
    - `video:writer`
    - `video:duration`
    - `video:release_date`
    - `video:tag`
    - `video:series` (video.tv_show) — Episode.

**video.tv_show**

 
:   TV show. Markup corresponds to the `video.movie` value.

**video.other**

 
:   Video that doesn't fall under any category listed above. Markup corresponds to the `video.movie` value.


{% endcut %}

{% cut "Other" %}


The following objects are supported although not included in verticals:

Values of the `og:type` meta tag:

**article**

 
:   - `article:published_time` (datetime) — Article publication date.
    - `article:modified_time` ( datetime) — The date of the last changes in the article.
    - `article:expiration_time` (datetime) — The date when the article expires.
    - `article:author` (profile, array) — The author of the article.
    - `article:section` (string) — Topic (section) of the article (for example, Technology).
    - `article:tag` (string, array) — Tags (words, phrases) related to the article.

**book**

 
:   - `book:author` (profile, array) — Book author.
    - `book:isbn` (string) — Book's unique numeric identifier ([ISBN](https://en.wikipedia.org/wiki/ISBN)).
    - `book:release_date` (datetime) — Book publication date.
    - `book:tag` (string, массив) — Tags (words, phrases) related to the book.

**profile**

 
:   - `profile:first_name` (string) — Name.
    - `profile:last_name` (string) — Surname.
    - `profile:username` (string) — Nickname (username under which the user is registered).
    - `profile:gender` (enum) — Gender (`male`, `female`).

**website**

 
:   Has no values except for the main ones. Any page which isn't marked up is recognised as a `site` object.


{% endcut %}

### Object types {#types-objects}


#|
||
**Type**
|
**Description**
|
**Examples of values**
||
||
Boolean
|
Can take `true` or `false`, 1 or 0 value.
|
true, false, 1, 0
||
||
DateTime
|
Time value. Can contain date (year, month, day) and time (hours, minutes) according to the [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) standard
|
2015-07-15, 15:05
||
||
Enum
|
Consists of a limited set of permanent string values
|
male, female
||
||
Float
|
64-bit floating point number
|
1.234, -1.234, 1.2e3, -1.2e3, 7E-10
||
||
Integer
|
32-bit integer. Can contain any characters that satisfy the following formats: 1234, -123
|
5, 15, 180
||
||
String
|
A sequence of [Unicode](https://en.wikipedia.org/wiki/Unicode) characters
|
webmaster
||
||
URL
|
All valid URLs accessible via the HTTP or HTTPS protocol
|
http://www.example.com
||
|#


## Usage example {#example}

To add information for snippet generation, specify the page header in the `head` element of the page HTML code. Specify the site header in the `og:title` and `og:site_name` properties.

```xml
<head>
    <meta property="og:title" content="Files / Updated Russian localization pack for Far Cry 4 / PlayGround.ru" />
</head>
```


```xml
<head>
    <meta property="og:site_name" content="Academic Dictionaries and Encyclopedias" />
</head>
```



\* Service banned in the Russian Federation.



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


{% cut "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.


{% endcut %}

{% cut "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.ru/support/webmaster/en/indexing-options/description.md) meta tag.


{% endcut %}

{% cut "Error in the structured data validator" %}


For a detailed description of errors, see [Structured data validator](https://yandex.ru/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.ru/surveys/5252/?&iframe=1&lang=en">
  </iframe>
  </div>




{% endcut %}


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




{% endcut %}

{% 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.ru/) [![](../_assets/logo/logo-ru.svg)](https://webmaster.yandex.ru/)





</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 -->

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

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

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

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

[*service]: Service banned in the territory of the Russian Federation.