CINXE.COM

<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <title>Data model - Schema.org</title>  <meta name="viewport" content="width=device-width, initial-scale=1"> <meta name="description" content="Schema.org is a set of extensible schemas that enables webmasters to embed structured data on their web pages for use by search engines and other applications." /> <link rel="shortcut icon" type="image/png" href="/docs/favicon.ico"/> <link rel="stylesheet" type="text/css" href="/docs/schemaorg.css" /> <link rel="stylesheet" type="text/css" href="/docs/devnote.css" /> <link rel="stylesheet" type="text/css" href="/docs/prettify.css" /> <link rel="stylesheet" type="text/css" href="/docs/devnote.css" /> <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script> <script src="/docs/schemaorg.js"></script>  </head> <body>  <div class="devnote"><b>Note</b>: You are viewing the development version of <a href="https://schema.org">Schema.org</a>. See <a href="/docs/howwework.html">how we work</a> for more details. </div> <div id="container"> <div id="headerwrap"> <div id="pagehead1" class="mobnav"> <div class="header-block" id="pagehead-left"> <div id="sitename2"> <a href="/">Schema.org</a> </div> </div> <div class="header-block header-block-right mobnav" id="pagehead-mid"> <div id="selectionbar2"> <ul> <li> <a href="/docs/documents.html">Docs</a> </li> <li> <a href="/docs/schemas.html">Schemas</a> </li> <li> <a href="https://validator.schema.org">Validate</a> </li> <li> <a href="/docs/about.html">About</a> </li> </ul> </div>  </div> <div class="header-block header-block-right mobnav" id="pagehead-right"> <div id="cse-search-form2" class="live-only"> <div class="gcse-searchbox-only" data-resultsUrl="/docs/search_results.html"></div> </div> </div> <div class="header-block mobnav" id="navicon2"> <a href="javascript:void(0);" class="icon" onclick="navFunction()"> <svg id="open" width="24px" height="24px" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg"> <g clip-path="url(#clip0_3560_173)"> <path d="M3 18V16H21V18H3ZM3 13V11H21V13H3ZM3 8V6H21V8H3Z" fill="#444746"/> </g> <defs> <clipPath id="clip0_3560_173"> <rect width="24" height="24" fill="white"/> </clipPath> </defs> </svg> <svg id="close" width="24px" height="24px" viewBox="0 -960 960 960" fill="#444746" xmlns="http://www.w3.org/2000/svg"> <path d="m256-200-56-56 224-224-224-224 56-56 224 224 224-224 56 56-224 224 224 224-56 56-224-224-224 224Z"/> </svg> </a> </div> </div> </div> <div class="header-bottom"></div> </div> <article id="mainContent"> <section> <h1>Data model</h1> <p> The following is a discussion about the data model used by schema.org. </p> <p> The data model used is very generic and derived from <a href="https://en.wikipedia.org/wiki/RDF_Schema">RDF Schema</a> (which in turn was derived from <a href="https://en.wikipedia.org/wiki/CycL">CycL</a>, see <a href="#history">History</a> section for details ...). </p> <ol> <li> We have a set of <b>types</b>, arranged in a <b>multiple inheritance hierarchy</b> where each type may be a sub-class of multiple types.</li> <li> We have a set of <b>properties</b>: <ol> <li> each property may have one or more types as its domains. The property may be used for instances of any of these types.</li> <li> each property may have one or more types as its ranges. The value(s) of the property should be instances of at least one of these types.</li> </ol> </li> </ol> <p> The decision to allow multiple domains and ranges was purely pragmatic. While the computational properties of systems with a single domain and range are easier to understand, in practice, this forces the creation of a lot of artificial types, which are there purely to act as the domain/range of some properties. </p> <p> Like many other systems, the schema presented here can be extended (with a few types like <a href="http://meta.schema.org/Class">Class</a> and <a href="http://meta.schema.org/Property">Property</a> and a few properties like <a href="http://meta.schema.org/domainIncludes">domainIncludes</a> and <a href="http://meta.schema.org/rangeIncludes">rangeIncludes</a>) to allow for reflection, i.e., for the schema to be represented in terms of itself. </p> <p>The canonical machine representation of schema.org is in RDF/Turtle. See the "<a href="/docs/developers.html">developers</a>" page for more information on machine-readable views of schema.org.</p> <p> The type hierarchy presented on this site is not intended to be a 'global ontology' of the world. When founded in 2011 it was strictly focused around the types of entities for which the project's founders (Microsoft, Yahoo!, Google and Yandex), could reasonably expect to provide some special treatment for via search engines. As the project has <a href="http://queue.acm.org/detail.cfm?id=2857276">evolved</a>, introducing more community collaboration and extension mechanisms, its scope has expanded gradually. However it is still the case that schema.org is not intended as a universal ontology. We expect it to be used alongside other vocabulary that shares our basic datamodel and our use of underlying standards like JSON-LD, Microdata and RDFa. </p> </section> <section> <h2 id="conformance">Conformance</h2>  <p> Although it might be helpful for search applications if structured data markup always followed schema.org very strictly, in practice this is unrealistic. Our schemas also continue to evolve in response to feedback, discussion and new applications of the data. Where possible we <a href="https://schema.org/docs/howwework.html">amend</a> existing definitions incrementally rather than introducing lots of new properties for similar use cases. We have consequently based schema.org on a very flexible datamodel, and take a pragmatic view of conformance. </p> <p> We expect schema.org properties to be used with new types, both from schema.org and from external extensions. We also expect that often, where we expect a property value of type Person, Place, Organization or some other subClassOf Thing, we will get a text string, even if our schemas don't formally document that expectation. In the spirit of "some data is better than none", search engines will often accept this markup and do the best we can. Similarly, some types such as <a href="/Role">Role</a> and <a href="/URL">URL</a> can be used with all properties, and we encourage this kind of experimentation amongst data consumers. </p> <h3 id="toolmakers">Notes for toolmakers and schema authors</h3> <p><em>This section is oriented towards extension authors and tool makers, i.e. creators of applications that consume, check or transform schema.org-based data. Most publishers and webmasters needn't worry about these details</em>.</p> <p> Applications of schema.org can address conformance in several ways. Tools such as validators can check for application-specific patterns, such as the data structures required for some specific functionality. They may also check compliance with underlying formats (JSON-LD, Microdata, RDFa etc.), or offer additional hints that go beyond formal conformance (e.g. checking for readability issues or implausible data). </p> <p> While it is appropriate and useful for such checkers to warn about published data that may be difficult or ambiguous for consumers, they are not obliged to treat unexpected structures as errors. Schema.org's underlying datamodel is naturally flexible, and provides an <a href="extension.html">extensible</a> basis for rich structured data. We encourage both publishers and consumers to continue to explore and <a href="https://www.w3.org/community/schemaorg/">share</a> new vocabulary ideas for <a href="/docs/releases.html">evolving</a> schema.org. </p> <p id="mtes"> It is not an error for a schema.org entity description to include properties from several independent types, e.g. something might simultaneously be both a <a href="/Book">Book</a> and a <a href="/Product">Product</a> and be usefully described with properties from both types. It is useful but not required for the relevant types to be included in such a description. This flexibility allows schema.org types to be developed with some decentralization, and for vocabulary to be re-used and combined in useful ways. When we list the expected types associated with a property (or vice-versa) we aim to indicate the main ways in which these terms will be combined in practice. This aspect of schema.org is naturally imperfect. For example the schemas for <a href="/Volcano">Volcano</a> suggest that since volcanoes are places, they may have fax numbers. Similarly, we list the unlikely (but not infeasible) possibility of a <a href="/Country">Country</a> having "opening hours". We do not attempt to perfect this aspect of schema.org's structure, and instead rely heavily on an extensive collection of illustrative examples that capture common and useful combinations of schema.org terms. The type/properties associations of schema.org are closer to "guidelines" than to formal rules, and improvements to the guidelines are always <a href="https://www.w3.org/community/schemaorg/">welcome</a>. </p> <p> See also: <a href="https://en.wikipedia.org/wiki/Robustness_principle">Postel's Law</a> </p> </section> <section> <h2>Mapping to RDFa Lite </h2> Our use of Microdata maps easily into <a href="http://www.w3.org/TR/rdfa-lite/">RDFa Lite</a>, and many of our examples now show both variations (alongside the newer <a href="https://en.wikipedia.org/wiki/JSON-LD">JSON-LD</a> syntax). All of Schema.org can be used with the RDFa Lite syntax. The RDFa Lite version of the markup looks almost isomorphic to the Microdata version. The following sample demonstrates the use of RDFa Lite to mark up a <a href="/Product">Product</a> type example: <pre class="prettyprint lang-html linenums"> <div vocab="https://schema.org/" typeof="Product"> <img property="image" src="dell-30in-lcd.jpg" /> <span property="name">Dell UltraSharp 30" LCD Monitor</span> <div property="aggregateRating" typeof="AggregateRating"> <span property="ratingValue">87</span> out of <span property="bestRating">100</span> based on <span property="ratingCount">24</span> user ratings </div> <div property="offers" typeof="AggregateOffer"> <span property="lowPrice">$1250</span> to <span property="highPrice">$1495</span> from <span property="offerCount">8</span> sellers </div> Sellers: <div property="offers" typeof="Offer"> <a property="url" href="save-a-lot-monitors.com/dell-30.html"> Save A Lot Monitors - $1250</a> </div> <div property="offers" typeof="Offer"> <a property="url" href="jondoe-gadgets.com/dell-30.html"> Jon Doe's Gadgets - $1350</a> </div> ... </div> </pre> <p> More specifically: </p> <ol> <li><code>itemprop</code> is replaced with <code>property</code>.</li> <li><code>itemscope</code> is dropped.</li> <li><code>itemtype</code> is replaced with <code>typeof</code>.</li> </ol> <p> In addition, the attribute value pair <code>vocab="https://schema.org/"</code> is added to the body or some other enclosing tag. </p> </section> <section> <h2 id="bgnotes">Background notes</h2> <p>The following sections provide additional information for some of schema.org's more general/abstract terms.</p> <h3 id="mainEntityBackground">mainEntity(OfPage) property</h3> <p>Background information on <a href="/mainEntityOfPage">mainEntityOfPage</a> / <a href="/mainEntity">mainEntity</a> properties.</p> <p><a href="/mainEntityOfPage">mainEntityOfPage</a> "Indicates a page (or other CreativeWork) for which this thing is the main entity being described."</p> <p>Many (but not all) pages have a fairly clear primary topic, some entity or thing that the page describes. For example a restaurant's home page might be primarily about that Restaurant, or an event listing page might represent a single event. The mainEntity and mainEntityOfPage properties allow you to explicitly express the relationship between the page and the primary entity.</p> <p>Related properties include <a href="/sameAs">sameAs</a>, <a href="/about">about</a>, and <a href="/url">url</a>.</p> <p>The <a href="/sameAs">sameAs</a> and <a href="/url">url</a> properties are both similar to <a href="/mainEntityOfPage">mainEntityOfPage</a>. The url property should be reserved to refer to more official or authoritative web pages, such as the item’s official website. The sameAs property also relates a thing to a page that indirectly identifies it. Whereas sameAs emphasises well known pages, the mainEntityOfPage property serves more to clarify which of several entities is the main one for that page.</p> <p>mainEntityOfPage can be used for any page, including those not recognized as authoritative for that entity. For example, for a product, sameAs might refer to a page on the manufacturer’s official site with specs for the product, while mainEntityOfPage might be used on pages within various retailers’ sites giving details for the same product.</p> <p><a href="/about">about</a> is similar to mainEntity, with two key differences. First, about can refer to multiple entities/topics, while mainEntity should be used for only the primary one. Second, some pages have a primary entity that itself describes some other entity. For example, one web page may display a news article about a particular person. Another page may display a product review for a particular product. In these cases, mainEntity for the pages should refer to the news article or review, respectively, while about would more properly refer to the person or product.</p> <h3 id="identifierBg">"identifier" property</h3> <p>Background information on the 'identifier' property and its sub-properties.</p> <p>The <a href="/identifier">identifier</a> property and its sub-properties are primarily useful in cases where the content is expressed as a textual string. Increasingly there are canonical URL/URI representations for each of these. All schema.org syntaxes already have built-in representation for URIs and URLs, e.g. in Microdata 'itemid', in RDFa 1.1, 'resource', in JSON-LD, '@id'. Generally it is preferable to use these unless there is a specific requirement to explicitly state the kind of identifier, or to provide additional / alternative identifiers (e.g., DOIs). Such requirements are common e.g. for scientific dataset description.</p> <p>In some cases the values of the <a href="/identifier">identifier</a> property indicate a set of (somewhat) interchangeable entities rather than a single distinct real world entity. Such sets could be viewed as corresponding to classes, but we do not explore that possibility here. For example <a href="/sku">sku</a> and the various product-related GTIN codes. However <a href="/identifier">identifier</a> is not intended to cover broader categorization and classification mechanisms. For example, although the <a href="/isicV4">isicV4</a> property has values that are in some sense identifiers, we do not treat <a href="/isicV4">isicV4</a> as a subproperty of <a href="/identifier">identifier</a> since it serves to identify a category not an individual Thing (specifically, <a href="/Person">Person</a>). Similarly, very many schema.org properties can have values that are written as URLs, but we do not treat those properties as specializations of <a href="/identifier">identifier</a>.</p> <p> In the most complex case, there is sometimes a need to represent the type of an identifier. In this case, a <a href="/PropertyValue">PropertyValue</a> pair ('name', 'identifier') pair can be used when a standard URI form of the identifier is unavailable. We do not currently have a recommended identifier scheme for identifier schemes, but in most cases there is a conventional short name for most identifier schemes (which should be used in lowercase form). </p> </section> <section> <h2 id="history">History</h2> <p>Previous related work:</p> <ul> <li><a href="https://www.w3.org/TR/rdf-schema/">RDF Schema</a></li> <li><a href="https://www.w3.org/TR/NOTE-MCF-XML-970606">Meta Content Framework (MCF) Using XML</a> (and <a href="https://www.w3.org/TR/NOTE-MCF-XML/MCF-tutorial.html">Tutorial</a>).</li> <li><a href="http://www.guha.com/mcf/wp.html">MCF whitepaper</a>, <a href="http://www.guha.com/mcf/mcf_spec.html">spec</a> and <a href="http://www.guha.com/mcf/vocab.html">basic vocabulary</a>.</li> <li>See also <a href="https://en.wikipedia.org/wiki/Semantic_network">Semantic network</a> article on Wikipedia.</li> </ul> </section> </article>  <div id="footer"> <p><a href="/docs/terms.html">Terms and conditions</a></p> <div id="versioninfo"> <span class="sep">•</span> Schema.org <span class="sep">•</span> V28.1 <span class="sep">|</span> 2024-11-22 </div> </div> <script> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-52672119-1', 'auto'); ga('send', 'pageview'); </script>  </body> </html>