mainEntity

Свойство schema.org ^?

Канонический URL: https://schema.org/mainEntity
👉 Проверить на наличие открытых проблем.

Содержание: Описание, Обратное свойство, Какие должны быть типы, В каких типах используется, Примеры использования.

Описание:

Указывает на основное сущность, описанную на странице или в другом произведении.

Свойство mainEntity в Schema.org используется для указания основной сущности, о которой идет речь на веб-странице или в другом творческом произведении. Это свойство помогает структурировать данные и улучшает понимание содержания страницы как для поисковых систем, так и для пользователей.

Основная цель использования mainEntity заключается в том, чтобы четко обозначить, какой объект или тема является центральной для представленного контента. Это может быть особенно полезно в контексте страниц, где представлено множество информации, например, на страницах с новостями, статьями или описаниями продуктов. Указывая mainEntity, разработчики могут помочь системам обработки данных (таким как поисковые системы) лучше интерпретировать и индексировать содержание страницы.

Свойство mainEntity обычно используется в контексте других свойств Schema.org, чтобы создать более полное и связное описание сущности. Например, если страница содержит информацию о конкретной книге, mainEntity будет указывать на эту книгу, а другие свойства могут предоставлять дополнительные детали, такие как автор, дата публикации и жанр.

В итоге, использование mainEntity способствует более ясному и структурированному представлению информации, что может улучшить видимость и понимание контента в интернете.

Обратное свойство: mainEntityOfPage

Ожидается, что значения будут одного из этих типов

Thing ^?

Используется в этих типах

CreativeWork ^?

Примеры

Пример 1

Пример заметки или HTML разметки.


<a href="category/books.html">Books</a> >
 <a href="category/books-literature.html">Literature &amp; Fiction</a> >
 <a href="category/books-classics">Classics</a>

<img src="catcher-in-the-rye-book-cover.jpg"
  alt="cover art: red horse, city in background"/>
The Catcher in the Rye - Mass Market Paperback
by <a href="/author/jd_salinger.html">J.D. Salinger</a>
4 stars - 3077 reviews

Price: $6.99
In Stock

Product details
224 pages
Publisher: Little, Brown, and Company - May 1, 1991
Language: English
ISBN-10: 0316769487

Reviews:

5 stars - <b>"A masterpiece of literature" </b>
by John Doe. Written on May 4, 2006
I really enjoyed this book. It captures the essential challenge people face
as they try make sense of their lives and grow to adulthood.

4 stars - <b>"love it LOLOL111!" </b>
by Bob Smith, Written on June 15, 2006
Catcher in the Rye is a fun book. It's a good book to read.

Пример, закодированный в формате Microdata, встроенный в HTML.


<body itemscope itemtype="https://schema.org/WebPage">
...
<div itemprop="breadcrumb">
  <a href="category/books.html">Books</a> >
  <a href="category/books-literature.html">Literature &amp; Fiction</a> >
  <a href="category/books-classics">Classics</a>
</div>

<div itemprop="mainEntity" itemscope itemtype="https://schema.org/Book">

<img itemprop="image" src="catcher-in-the-rye-book-cover.jpg"
     alt="cover art: red horse, city in background"/>
<span itemprop="name">The Catcher in the Rye</span> -
 <link itemprop="bookFormat" href="https://schema.org/Paperback">Mass Market Paperback
by <a itemprop="author" href="/author/jd_salinger.html">J.D. Salinger</a>

<div itemprop="aggregateRating" itemscope itemtype="https://schema.org/AggregateRating">
  <span itemprop="ratingValue">4</span> stars -
  <span itemprop="reviewCount">3077</span> reviews
</div>

<div itemprop="offers" itemscope itemtype="https://schema.org/Offer">
  Price: $<span itemprop="price">6.99</span>
  <meta itemprop="priceCurrency" content="USD" />
  <link itemprop="availability" href="https://schema.org/InStock">In Stock
</div>

Product details
<span itemprop="numberOfPages">224</span> pages
Publisher: <span itemprop="publisher">Little, Brown, and Company</span> -
 <meta itemprop="datePublished" content="1991-05-01">May 1, 1991
Language: <span itemprop="inLanguage">English</span>
ISBN-10: <span itemprop="isbn">0316769487</span>

Reviews:

<div itemprop="review" itemscope itemtype="https://schema.org/Review">
  <span itemprop="reviewRating">5</span> stars -
  <b>"<span itemprop="name">A masterpiece of literature</span>"</b>
  by <span itemprop="author">John Doe</span>,
  Written on <meta itemprop="datePublished" content="2006-05-04">May 4, 2006
  <span itemprop="reviewBody">I really enjoyed this book. It captures the essential
  challenge people face as they try make sense of their lives and grow to adulthood.</span>
</div>

<div itemprop="review" itemscope itemtype="https://schema.org/Review">
  <span itemprop="reviewRating">4</span> stars -
  <b>"<span itemprop="name">A good read.</span>" </b>
  by <span itemprop="author">Bob Smith</span>,
  Written on <meta itemprop="datePublished" content="2006-06-15">June 15, 2006
  <span itemprop="reviewBody">Catcher in the Rye is a fun book. It's a good book to read.</span>
</div>

</div>
...
</body>

Пример, закодированный в формате RDFa, встроенный в HTML.


<body vocab="https://schema.org/" typeof="WebPage">
...
<div property="breadcrumb">
  <a href="category/books.html">Books</a> >
  <a href="category/books-literature.html">Literature &amp; Fiction</a> >
  <a href="category/books-classics">Classics</a>
</div>

<div property="mainEntity" typeof="Book">

<img property="image" src="catcher-in-the-rye-book-cover.jpg"
    alt="cover art: red horse, city in background"/>
<span property="name">The Catcher in the Rye</span> -
 <link property="bookFormat" href="https://schema.org/Paperback">Mass Market Paperback
by <a property="author" href="/author/jd_salinger.html">J.D. Salinger</a>

<div property="aggregateRating" typeof="AggregateRating">
  <span property="ratingValue">4</span> stars -
  <span property="reviewCount">3077</span> reviews
</div>

<div property="offers" typeof="Offer">
  Price: $<span property="price">6.99</span>
  <meta property="priceCurrency" content="USD" />
  <link property="availability" href="https://schema.org/InStock">In Stock
</div>

Product details
<span property="numberOfPages">224</span> pages
Publisher: <span property="publisher">Little, Brown, and Company</span> -
 <meta property="datePublished" content="1991-05-01">May 1, 1991
Language: <span property="inLanguage">English</span>
ISBN-10: <span property="isbn">0316769487</span>

Reviews:

<div property="review" typeof="Review">
  <span property="reviewRating">5</span> stars -
  <b>"<span property="name">A masterpiece of literature</span>"</b>
  by <span property="author">John Doe</span>,
  Written on <meta property="datePublished" content="2006-05-04">May 4, 2006
  <span property="reviewBody">I really enjoyed this book. It captures the essential
  challenge people face as they try make sense of their lives and grow to adulthood.</span>
</div>

<div property="review" typeof="Review">
  <span property="reviewRating">4</span> stars -
  <b>"<span property="name">A good read.</span>" </b>
  by <span property="author">Bob Smith</span>,
  Written on <meta property="datePublished" content="2006-06-15">June 15, 2006
  <span property="reviewBody">Catcher in the Rye is a fun book. It's a good book to read.</span>
</div>

</div>
...
</body>

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebPage",
  "breadcrumb": "Books > Literature & Fiction > Classics",
  "mainEntity":{
	  "@type": "Book",
	  "author": "/author/jd_salinger.html",
	  "bookFormat": "https://schema.org/Paperback",
	  "datePublished": "1991-05-01",
	  "image": "catcher-in-the-rye-book-cover.jpg",
	  "inLanguage": "English",
	  "isbn": "0316769487",
	  "name": "The Catcher in the Rye",
	  "numberOfPages": "224",
	  "offers": {
	    "@type": "Offer",
	    "availability": "https://schema.org/InStock",
	    "price": "6.99",
	    "priceCurrency": "USD"
	  },
	  "publisher": "Little, Brown, and Company",
	  "aggregateRating": {
	    "@type": "AggregateRating",
	    "ratingValue": "4",
	    "reviewCount": "3077"
	  },
	  "review": [
	    {
	      "@type": "Review",
	      "author": "John Doe",
	      "datePublished": "2006-05-04",
	      "name": "A masterpiece of literature",
	      "reviewBody": "I really enjoyed this book. It captures the essential challenge people face as they try make sense of their lives and grow to adulthood.",
	      "reviewRating": {
            "@type": "Rating",
            "ratingValue": "5"
           }
	    },
	    {
	      "@type": "Review",
	      "author": "Bob Smith",
	      "datePublished": "2006-06-15",
	      "name": "A good read.",
	      "reviewBody": "Catcher in the Rye is a fun book. It's a good book to read.",
	      "reviewRating": "4"
	    }
	  ]
  	}
}
</script>

Структурированное представление примера JSON-LD.

@context

https://schema.org

@type

WebPage

breadcrumb

Books > Literature & Fiction > Classics

mainEntity

@type

Book

author

/author/jd_salinger.html

bookFormat

https://schema.org/Paperback

datePublished

1991-05-01

image

catcher-in-the-rye-book-cover.jpg

inLanguage

English

isbn

0316769487

name

The Catcher in the Rye

numberOfPages

224

offers

@type: Offer
availability: https://schema.org/InStock
price: 6.99
priceCurrency: USD

publisher

Little, Brown, and Company

aggregateRating

@type: AggregateRating
ratingValue: 4
reviewCount: 3077

review

0

@type

Review

author

John Doe

datePublished

2006-05-04

name

A masterpiece of literature

reviewBody

I really enjoyed this book. It captures the essential challenge people face as they try make sense of their lives and grow to adulthood.

reviewRating

@type: Rating
ratingValue: 5

1

@type: Review
author: Bob Smith
datePublished: 2006-06-15
name: A good read.
reviewBody: Catcher in the Rye is a fun book. It's a good book to read.
reviewRating: 4

Пример 2

Пример заметки или HTML разметки.


     <div>
      <h1>Cath's Cafe</h1>
      <p>Open: Daily from 11:00am till 8pm</p>
      <p>Phone: 555-0100-3344</p>
      <p>View <a href="/menu">our menu</a>.</p>
     </div>

Пример, закодированный в формате Microdata, встроенный в HTML.


<div itemid="http://cathscafe.example.com/" itemscope itemtype="https://schema.org/WebPage">
    <div itemprop="mainEntity" itemscope itemtype="https://schema.org/Restaurant" itemid="#thecafe">
      <h1 itemprop="name">Cath's Cafe</h1>
      <p>Open: <span itemprop="openingHours" content="Mo,Tu,We,Th,Fr,Sa,Su 11:00-20:00">Daily from 11:00am till 8pm</span></p>
      <p>Phone: <span itemprop="telephone" content="+155501003344">555-0100-3344</span></p>
      <p>View <a itemprop="hasMenu" href="/menu">our menu</a>.</p>
    </div>
</div>

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<script type="application/ld+json">
{
    "@context": "https://schema.org",
    "@type": "WebPage",
    "@id": "http://cathscafe.example.com/",
    "mainEntity": {
      "@type": "Restaurant",
      "name": "Cath's Cafe",
      "openingHours": "Mo,Tu,We,Th,Fr,Sa,Su 11:00-20:00",
      "telephone": "+155501003344",
      "hasMenu": "/menu"
    }
}
</script>

Структурированное представление примера JSON-LD.

@context

https://schema.org

@type

WebPage

@id

http://cathscafe.example.com/

mainEntity

@type: Restaurant
name: Cath's Cafe
openingHours: Mo,Tu,We,Th,Fr,Sa,Su 11:00-20:00
telephone: +155501003344
hasMenu: /menu

Пример 3

Это пример от schema.su, его нету в официальной документации! Будьте внимательны, работоспособность не можем гарантировать. Проверяйте через валидатор.

Пример заметки или HTML разметки.

Страница Вопросов и Ответов (FAQ)

Вопрос 1: Какие способы оплаты вы принимаете?
Ответ 1: Мы принимаем кредитные карты, PayPal и банковские переводы.

Вопрос 2: Какова ваша политика возврата?
Ответ 2: Вы можете вернуть товар в течение 30 дней с момента покупки, если он в оригинальной упаковке.

Вопрос 3: Как я могу связаться с поддержкой клиентов?
Ответ 3: Вы можете связаться с нами по электронной почте support@example.com или по телефону +7 (123) 456-78-90.

Пример, закодированный в формате Microdata, встроенный в HTML.

<div itemscope itemtype="https://schema.org/FAQPage">
  <h1>Страница Вопросов и Ответов (FAQ)</h1>
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <h2 itemprop="name">Какие способы оплаты вы принимаете?</h2>
    <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
      <p itemprop="text">Мы принимаем кредитные карты, PayPal и банковские переводы.</p>
    </div>
  </div>
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <h2 itemprop="name">Какова ваша политика возврата?</h2>
    <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
      <p itemprop="text">Вы можете вернуть товар в течение 30 дней с момента покупки, если он в оригинальной упаковке.</p>
    </div>
  </div>
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <h2 itemprop="name">Как я могу связаться с поддержкой клиентов?</h2>
    <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
      <p itemprop="text">Вы можете связаться с нами по электронной почте support@example.com или по телефону +7 (123) 456-78-90.</p>
    </div>
  </div>
</div>

Пример, закодированный в формате JSON-LD в теге <script> HTML.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Какие способы оплаты вы принимаете?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Мы принимаем кредитные карты, PayPal и банковские переводы."
      }
    },
    {
      "@type": "Question",
      "name": "Какова ваша политика возврата?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Вы можете вернуть товар в течение 30 дней с момента покупки, если он в оригинальной упаковке."
      }
    },
    {
      "@type": "Question",
      "name": "Как я могу связаться с поддержкой клиентов?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Вы можете связаться с нами по электронной почте support@example.com или по телефону +7 (123) 456-78-90."
      }
    }
  ]
}
</script>

Структурированное представление примера JSON-LD.

@context

https://schema.org

@type

FAQPage

mainEntity

0

@type

Question

name

Какие способы оплаты вы принимаете?

acceptedAnswer

@type: Answer
text: Мы принимаем кредитные карты, PayPal и банковские переводы.

1

@type

Question

name

Какова ваша политика возврата?

acceptedAnswer

@type: Answer
text: Вы можете вернуть товар в течение 30 дней с момента покупки, если он в оригинальной упаковке.

2

@type

Question

name

Как я могу связаться с поддержкой клиентов?

acceptedAnswer

@type: Answer
text: Вы можете связаться с нами по электронной почте support@example.com или по телефону +7 (123) 456-78-90.

Пример 4

Пример заметки или HTML разметки.

Тип: Страница профиля
Имя: Иван Иванов
Описание: Профиль Ивана Иванова, программиста и веб-разработчика.
Изображение: https://example.com/images/ivan-ivanov.jpg
URL: https://example.com/ivan-ivanov

Пример, закодированный в формате Microdata, встроенный в HTML.

<div itemscope itemtype="https://schema.org/ProfilePage">
    <div itemprop="mainEntity" itemscope itemtype="https://schema.org/Person">
        <span itemprop="name">Иван Иванов</span>
        <img itemprop="image" src="https://example.com/images/ivan-ivanov.jpg" alt="Иван Иванов" />
        <span itemprop="description">Профиль Ивана Иванова, программиста и веб-разработчика.</span>
        <a itemprop="url" href="https://example.com/ivan-ivanov">Профиль Ивана Иванова</a>
    </div>
</div>

Пример, закодированный в формате JSON-LD в теге <script> HTML.

<script type="application/ld+json">
{
    "@context": "https://schema.org",
    "@type": "ProfilePage",
    "mainEntity": {
        "@type": "Person",
        "name": "Иван Иванов",
        "description": "Профиль Ивана Иванова, программиста и веб-разработчика.",
        "image": "https://example.com/images/ivan-ivanov.jpg",
        "url": "https://example.com/ivan-ivanov"
    }
}
</script>

Структурированное представление примера JSON-LD.

@context

https://schema.org

@type

ProfilePage

mainEntity

@type: Person
name: Иван Иванов
description: Профиль Ивана Иванова, программиста и веб-разработчика.
image: https://example.com/images/ivan-ivanov.jpg
url: https://example.com/ivan-ivanov

Пример 5

Пример заметки или HTML разметки.

Тип: Страница вопросов и ответов
Название: Часто задаваемые вопросы о нашем сервисе
Описание: Страница, на которой собраны ответы на часто задаваемые вопросы о нашем сервисе.
URL: https://example.com/faq

Вопрос 1: Как зарегистрироваться на сайте?
Ответ 1: Для регистрации на сайте вам нужно заполнить форму на странице регистрации.

Вопрос 2: Как сменить пароль?
Ответ 2: Чтобы сменить пароль, используйте опцию "Забыли пароль" на странице входа.

Пример, закодированный в формате Microdata, встроенный в HTML.

<div itemscope itemtype="https://schema.org/QAPage">
    <h1 itemprop="name">Часто задаваемые вопросы о нашем сервисе</h1>
    <p itemprop="description">Страница, на которой собраны ответы на часто задаваемые вопросы о нашем сервисе.</p>
    <a itemprop="url" href="https://example.com/faq">Посетите нашу страницу FAQ</a>
    <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
        <h2 itemprop="name">Как зарегистрироваться на сайте?</h2>
        <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
            <p itemprop="text">Для регистрации на сайте вам нужно заполнить форму на странице регистрации.</p>
        </div>
    </div>
    <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
        <h2 itemprop="name">Как сменить пароль?</h2>
        <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
            <p itemprop="text">Чтобы сменить пароль, используйте опцию "Забыли пароль" на странице входа.</p>
        </div>
    </div>
</div>

Пример, закодированный в формате JSON-LD в теге <script> HTML.

<script type="application/ld+json">
{
    "@context": "https://schema.org",
    "@type": "QAPage",
    "name": "Часто задаваемые вопросы о нашем сервисе",
    "description": "Страница, на которой собраны ответы на часто задаваемые вопросы о нашем сервисе.",
    "url": "https://example.com/faq",
    "mainEntity": [
        {
            "@type": "Question",
            "name": "Как зарегистрироваться на сайте?",
            "acceptedAnswer": {
                "@type": "Answer",
                "text": "Для регистрации на сайте вам нужно заполнить форму на странице регистрации."
            }
        },
        {
            "@type": "Question",
            "name": "Как сменить пароль?",
            "acceptedAnswer": {
                "@type": "Answer",
                "text": "Чтобы сменить пароль, используйте опцию 'Забыли пароль' на странице входа."
            }
        }
    ]
}
</script>

Структурированное представление примера JSON-LD.

@context

https://schema.org

@type

QAPage

name

Часто задаваемые вопросы о нашем сервисе

description

Страница, на которой собраны ответы на часто задаваемые вопросы о нашем сервисе.

url

https://example.com/faq

mainEntity