Distance

Distance is a Quantity subtype. Properties that take Distances as values are of the form '<Number> <Length unit of measure>'. E.g., '7 ft'.

Full example of schema.org/Distance json-ld markup

The markup is verified as valid with Rich Results Test from Google.

schema.org/Distance

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Distance",
  "name": "Example Distance"
}
</script>

Minimal valid version

The smallest markup that still produces a valid Distance entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/Distance (minimal)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Distance",
  "name": "Example"
}
</script>

Google rich results this unlocks

Distance is a structural type. It does not produce a rich result on its own.

Its value comes from combining it with a primary type whose markup earns a rich result (Article, Product, Event, and so on). Distance becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

Common Distance mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

01
Using bare Quantity instead of the specific Distance subtype
Wrong
```
"@type": "Quantity"
```
Right
```
"@type": "Distance"
```
Specific subtypes carry domain context consumers use; reach for the narrowest applicable type.

Schema properties in this example

Distance Quantity

Also mentioned in 2 other examples

Distance also appears in ExerciseAction, and TravelAction. See the full Distance schema page for every reference.

About the example data

Reference entry in the Xoo Code schema.org catalogue.

Comments

Loading comments...