QuantitativeValueDistribution

QuantitativeValueDistribution is a StructuredValue for a distribution of values rather than a single point. It is the parent of MonetaryAmountDistribution.

Direct properties:

duration (Duration or QuantitativeValue): the time period the distribution describes (hourly, annual).
median (Number): the 50th-percentile value.
percentile10 (Number): 10th-percentile value.
percentile25 (Number): 25th-percentile value.
percentile75 (Number): 75th-percentile value.
percentile90 (Number): 90th-percentile value.

For currency-denominated distributions (wages, prices), use MonetaryAmountDistribution which adds currency.

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

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

Highlight legend:Required by GoogleRecommendedOptional

schema.org/QuantitativeValueDistribution

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "QuantitativeValueDistribution",
  "name": "Hours worked per week, Dunmore hospitality staff (2025 survey)",
  "duration": "P1W",
  "unitText": "hours per week",
  "percentile10": 12,
  "percentile25": 22,
  "median": 32,
  "percentile75": 40,
  "percentile90": 48
}
</script>

Minimal valid version

The smallest markup that still produces a valid QuantitativeValueDistribution 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/QuantitativeValueDistribution (minimal)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "QuantitativeValueDistribution",
  "median": 32,
  "percentile25": 22,
  "percentile75": 40
}
</script>

Google rich results this unlocks

Markup matching this example makes your page eligible for the following Google Search rich results. The primary target drives the required / recommended property classification in the advanced code block above.

No dedicated rich result (statistical-data graphs)
Google docs

Common QuantitativeValueDistribution 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
Percentiles out of order
Wrong
```
percentile25 > percentile75
```
Right
```
The fields are ordered: 10, 25, 50 (median), 75, 90 ascending
```
Statistical consumers validate ordering; violations break rendering and chart generation.
02
Missing duration
Wrong
```
Distribution with no duration
```
Right
```
Populate duration so the time scope is explicit
```
Wages measured hourly vs annually look identical without duration; the scope is essential.

Schema properties in this example

QuantitativeValueDistribution StructuredValue Intangible name duration unitText percentile10 percentile25 median percentile75 percentile90 MonetaryAmountDistribution

About the example data

The distribution of hours worked per week by Dunmore hospitality staff.

Comments

Loading comments...