How To: Use the Schema Paths Tool

Modified on Fri, 22 Mar 2024 at 05:35 PM

This support document describes how to use the Schema Paths Tool, an excellent resource when you're not sure the best property to use to connect two entities. You can access the Schema Paths Tool from within your Schema App account or at our free, publicly-accessible Schema Paths webpage.

The tool will require you to select two classes to connect. You can select them from the drop-down list, or type in the name of the class you’re looking for. Then click on “Click to find a path”. Essentially, you’re asking the tool: how can these things be connected? The tool will present you with a list of all possible properties to relate these data item types.

TIP! If you’re unsure how the properties are defined, clicking them will open their entry in


Select your first class, second class, and click "Click to find paths"

You’ll notice the Schema Paths tool presents available properties in two directions: 

  1. Possible Paths, which connect the first selected class to the second, and 
  2. Reversal Paths, connecting the second class to the first. 
We do this because we want to reflect the fact that sometimes it's important to denote the primary class or entity of a page. We treat the Type in the Class 1 drop down as the primary class. Assuming it is at the top of the hierarchy, and the second class is be embedded within it.  Reversal paths assume that the Type in the Class 2 drop down is the primary class.

You'll also notice that certain selected classes will only return paths in one direction. This is because the rules governing these data item types only allow for a unilateral relationship. For example, the Schema Paths tool will only show Reversal Paths connecting a Service to an Organization. So, if you wanted your schema markup to state that an Organization provides a Service, the statement would have to be: Service → has provider →  Organization. The Service would need to be the primary entity, and the Organization would be embedded within it by way of the provider property.

The Organization and Service classes can only be connected by Reversal Paths

Getting to know all the types and properties in’s vocabulary is a bit like learning grammar for a new language—but getting it right doesn’t have to be hard! Equipped with the Schema Paths tool, you can ensure you’re leveraging the semantic relationships between data items quickly, effectively, and painlessly.


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
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article