schema.org

schema.org is a shared vocabulary for describing things on the Web — people, organisations, events, places, creative works and many more — so that machines can read what a page is about, not only what it says. It was launched in 2011 by Google, Microsoft (Bing) and Yahoo!, soon joined by Yandex, and is maintained as an open community project at schema.org, hosted by a W3C community group.

How it works

The vocabulary is a hierarchy of types — Thing > CreativeWork > Article > ScholarlyArticle, for instance — each with its properties, whose values can be text, numbers, dates or other typed objects. A page describes itself in one of three syntaxes: Microdata and RDFa, which annotate the visible HTML, or JSON-LD, a separate block of JSON in a <script> element, which is the one search engines recommend:

<script type="application/ld+json">
{
 "@context": "https://schema.org",
 "@type": "ScholarlyArticle",
 "name": "A paper title",
 "author": [{"@type": "Person", "name": "Jane Doe"}],
 "datePublished": "2024",
 "isPartOf": {"@type": "PublicationIssue", "issueNumber": "3",
   "isPartOf": {"@type": "PublicationVolume", "volumeNumber": "12",
     "isPartOf": {"@type": "Periodical", "name": "A Journal", "issn": "1234-5678"}}},
 "sameAs": ["https://doi.org/10.1234/example"]
}
</script>

Unlike Open Graph, which flattens a page into a few strings for a preview card, schema.org describes a graph: an article is part of an issue, which is part of a volume of a periodical; its authors are persons, who may be affiliated with organisations. The @id and sameAs properties identify the same thing across sites — a DOI, an ORCID, an OpenAlex identifier.

Types for research

typefor
ScholarlyArticlea journal or conference paper
Chaptera chapter in a book
Booka monograph, an edited volume, a proceedings volume
Periodical, PublicationVolume, PublicationIssuea journal, its volumes and its issues
Thesisa thesis or dissertation
Reporta technical report
Dataset, SoftwareSourceCoderesearch data and software
Person, Organizationauthors, editors, affiliations, publishers
Event, Course, Grantconferences, courses, research funding

Who reads it

  • Search engines — Google, Bing, Yandex — use it to understand pages and, for some types, to show rich results. Google Dataset Search is built on Dataset markup.
  • Knowledge graphs and aggregators harvest it to link the same entity across sites.
  • Google Scholar relies on the citation_* tags instead. Social networks read Open Graph. The vocabularies serve different readers and are used side by side.

A page can be checked with the Schema Markup Validator, which tests the vocabulary, and Google's Rich Results Test, which tests what Google makes of it.

See also