Common Schema.org Properties for Connecting and Disambiguating Data Items

At Schema App we value making structured data as specific as possible. Below are descriptions of common properties and practices used by Schema App to disambiguate schema markup.

TABLE OF CONTENTS

• about
• additionalType
• mainEntityOfPage
• mainEntity
• mentions
• sameAs
• url
• @id

about

The about property is used to express the subject matter of something (usually a CreativeWork). It can refer to multiple entities or topics which must be typed as Thing, or any more specific type within the Schema.org vocabulary. If you're linking to an external authority, like Wikipedia or Wikidata, note that the URL you provide will be typed as Thing by default unless you set a more specific Schema type.

additionalType

The additionalType property is used to add more specific types from external vocabularies or authorities like Wikipedia or Wikidata. These should be in the form of URLs. For more information, see our article, How to use the additionalType and sameAs properties.

mainEntityOfPage

The mainEntityOfPage property is used to explicitly express the relationship between a page and its primary entity. If several entities are referenced on the page, this property clarifies the main one. Schema App frequently uses this property to assert the canonical URL of Articles and BlogPostings.

mainEntity

The mainEntity property is used onb all types of CreativeWorks to say that the CreativeWork is primarily about a particular entity. 

mentions

The mentions property is similar to about in that it can refer to multiple entities or topics; however, it is a looser connector. The primary or secondary topic of an article would be linked to using about, whereas mentions is more appropriate for calling out entities or topics that are referenced but not explored in depth. For example, a MedicalWebPage that's about a MedicalCondition, but also mentions other related conditions without going into detail.

sameAs

The sameAs property relates a thing (data item) to a URL that indirectly identifies it. It's most commonly used to link Organizations and Businesses to their social media sites. It's also useful for linking data items to authorities like Wikipedia or Wikidata. Note that sameAs should only be used to express that an entity is exactly the same as an entity from another source. For more information, see our article, How to use the additionalType and sameAs properties.

url

The url property should be reserved to refer to more official or authoritative web pages, such as the item’s official location on a website. For example, the URL of an Organization data item would be the homepage of the website about that Organization. 

@id

While not a property in Schema.org, @id is used in JSON-LD to uniquely identify things (or data items) described in a document. Schema App automatically generates @ids for each data item you create so that they can be unambiguously identified and referenced by other data items in your schema markup graph.