---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.3
alternate:
  - https://www.yandex.com/support/metrica/en/publishers/open-graph/open-graph.md
  - https://www.yandex.com/support/metrica/es/publishers/open-graph/open-graph.md
  - https://www.yandex.com/support/metrica/pt/publishers/open-graph/open-graph.md
  - https://www.yandex.com/support/metrica/ru/publishers/open-graph/open-graph.md
  - https://www.yandex.com/support/metrica/tr/publishers/open-graph/open-graph.md
  - href: https://www.yandex.com/support/metrica/en/publishers/open-graph/open-graph.md
    type: text/markdown
    title: Markdown version
  - href: https://www.yandex.com/support/metrica/en/llms.txt?revision=r21661110
    rel: describedby
title: Open Graph
description: A vocabulary used for the semantic markup of data. It lets you control the preview that is generated when publishing links on social networks and transmit information to other internet services.
---
> **Documentation Index:** Fetch the complete configuration index at https://www.yandex.com/support/metrica/en/llms.txt?revision=r21661110


# Open Graph

Open Graph is a vocabulary used for the semantic markup of web data. It lets you control the preview that is generated when publishing links on social networks and transmit information to other internet services.

[Open Graph official website](https://ogp.me/)

<!-- source: en/_includes/publishers/schema-org/schema-org/id-schema-org/uni.md -->
{% note info %}

Data with markup is public and any service can extract and use it.

{% endnote %}
<!-- endsource: en/_includes/publishers/schema-org/schema-org/id-schema-org/uni.md -->

<!-- source: en/_includes/publishers/about/id-about/plug.md -->
{% note alert %}

If you embed micro markup using a plugin, you’ll probably need to modify it. To do this, contact the plugin developer or another professional with development skills.

{% endnote %}
<!-- endsource: en/_includes/publishers/about/id-about/plug.md -->

## Markup principles {#how-to}

Data about an object in Open Graph is described by sets of property-value pairs in meta tags. The property must be specified in `property` and its value must be specified in `content`.

{% note info %}

Properties and values are case-sensitive. Specify them as shown in the examples and the standard.

{% endnote %}

The standard requires that Open Graph data be located in the `head` tag. However, to collect content statistics, we recommend placing meta tags in the node where the content is embedded, especially when there are multiple content items on the page. This is necessary for the correct calculation of the full scroll and full read metrics.

## How to mark up materials {#material}

Mark up the following content elements (mandatory elements are marked with an asterisk):

#|
||
- [Type of the described object*](#object)
- [Title*](#headline-desc)
- [Text*](#text-desc)
- [Author](#author-desc)
- [Subject](#about-desc)
|
- [Dates of publication and revisions](#dates-desc)
- [Category](#rubric-desc)
- [Content URL](#canonical-desc)
|||#

**Type of the described object*** {#object}

 
:   Yandex Metrica only supports [article](https://ogp.me/#type_article) markup. Other types of content will not be included in Yandex Metrica reports even with the correct markup. The type of object is specified in the `og:type` property.
    
    ```html
    <meta property="og:type" content="article">
    ```

**Title*** {#headline-desc}

 
:   The headline is shown in Yandex Metrica reports. It is specified in the property `og:title`.
    ```html
    <meta property="og:title" content="The temperature in Moscow on Wednesday, November 6 broke the record set in 1922.">
    ```

**Text*** {#text-desc}

 
:   The text is the content of the node that contains the described material. If the markup is in the `head` tag, the text will be the entire contents of the `body` tag. Tag symbols are not taken into account. The text defines the number of characters. This is necessary to determine the volume of material and calculate scroll depth and read depth metrics.
    
    {% note info %}
    
    You can get complete statistics for the content with text longer than 500 characters.
    
    {% endnote %}

**Author** {#author-desc}

 
:   The author is specified using the `article:author` property. If there are several authors, list them in different meta tags.
    
    ```html
    <meta property="article:author" content="John Smith">
    <meta property="article:author" content="Dylan Brown">
    ```
    
    With this data, you can view statistics for individual authors.

**Subject** {#about-desc}

 
:   You can mark up keywords and hashtags as topics. Specify the topics in the `article:tag` property. If there are multiple topics, list them in different meta tags.
    
    ```html
    <meta property="article:tag" content="Heat">
    <meta property="article:tag" content="Moscow">
    ```

**Dates of publication and revision** {#dates-desc}

 
:   Publication dates and changes are specified in the `article:published_time` and `article:modified_time` properties. Dates are written in [ISO 8601](https://www.iso.org/standard/40874.html) format.
    
    ```html
    <meta property="article:modified_time" content="2018-12-11T08:56:49Z">
    <meta property="article:published_time" content="2018-11-06T09:26:10+04:00">
    ```

**Category** {#rubric-desc}

 
:   A heading is a section of a website dedicated to a specific topic. To specify a material category, use the property `article:section`.
    
    ```html
    <meta property="article:section" content="Weather">
    ```

**Content URL** {#canonical-desc}

 
:   The content URL must be contained in the property `og:url`.
    
    ```html
    <meta property="og:url" content="https://www.example-news.com/life/weather/moscow"/>
    ```
    
    Otherwise, the value will be taken from the canonical link:
    
    ```html
    <link rel="canonical" href="https://www.example-news.com/life/weather/moscow">
    ```

If the markup is correct and the tag is properly enabled, statistics on the content will soon start to be collected in Yandex Metrica.

## Markup example {#example}

```html
<html prefix="og:http://ogp.me/ns# article:http://ogp.me/ns/article#">
  <head>
    <title>Moscow breaks the 1922 temperature record</title>
    <meta property="og:type" content="article"/>
    <meta property="og:title" content="Moscow breaks the 1922 temperature record"/>
    <meta property="og:url" content="https://www.example-news.com/life/weather/moscow#cao"/>
    <meta property="article:section" content="Weather">
    <meta property="article:modified_time" content="2018-12-11T08:56:49Z">
    <meta property="article:published_time" content="2018-11-06T09:26:10+04:00">   
    <meta property="article:author" content="John Smith">
    <meta property="article:author" content="Dylan Brown">
    <meta property="article:tag" content="Heat">
    <meta property="article:tag" content="Moscow">
    ...
  </head>  
 <body>
   <div>
     On Wednesday, November 6, Moscow broke the temperature 
      record registered in 1922. The air temperature was 12.1 °C, 
      according to the Fobos center.
   </div>
   ...
 </body>
</html>
```

## Learn more

- [Content reports](https://www.yandex.com/support/metrica/en/publishers/reports/main.md)

<!-- source: en/_includes/buttons/chat-button.md -->
[Chat with us](https://yandex.com/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}



<!-- source: en/_includes/styles/href-to-button.md -->

<!-- endsource: en/_includes/styles/href-to-button.md -->
<!-- endsource: en/_includes/buttons/chat-button.md -->

<!-- source: en/_includes/publishers/support-button.md -->
<div class="cut-button">

{% cut "Write an email" %}

<!-- source: en/_includes/popup/id-popup/wrong-sup.md -->
Please note: Our support team will never initiate a call to you. Do not follow any instructions of people who call you and introduce themselves as the Yandex Metrica support team.
<!-- endsource: en/_includes/popup/id-popup/wrong-sup.md -->

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

{% endcut %}

</div>

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

<!-- endsource: en/_includes/styles/cut-button.md -->
<!-- endsource: en/_includes/publishers/support-button.md -->

{% include [footer-links](../../_includes/footer-links.md) %}

{% included (../../_includes/footer-links.md) %}

- - -

<div class="borderless-table">

#|
||
Useful links

- [Demo tag](https://metrica.yandex.com/r/dashboard?)
- [Add a tag](https://metrica.yandex.com/add/)
- [Free tag setup](https://yandex.com/promo/freeservice/metrica?utm_source=help_metrica_en&utm_medium=cpc&utm_campaign=1)
- [Yandex Metrica API](https://tech.yandex.com/metrika/)
- [Suggest your idea](https://yandex.com/support/metrica/troubleshooting/idea.html)
- [Discuss in Telegram](https://t.me/yandexmetrika)
|
Online training

- [Get a Yandex Metrica certificate](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)


- [Take a training course](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)

||
|#

</div>

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

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


{% endincluded %}
{% included (../../_includes/footer-links.md:styles/table-style.md) %}


{% endincluded %}