Common Properties for Connecting and Disambiguating Data Items

Modified on Thu, 25 Jan 2024 at 10:53 AM

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.



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 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.


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.


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.


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


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.


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.


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. 


While not a property in, @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. 

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article