StatisticalPopulation

StatisticalPopulation is an Intangible for a population defined by a set of constraints — age ranges, income brackets, occupation, location. It is the subject of Observation entries for demographic statistics.

Direct properties:

populationType (Text or URL): the kind of population (e.g. https://schema.org/Person, Household).
numConstraints (Integer): the number of constraints applied (consumers use this to verify nothing is missing).

Additional constraints (age, gender, education level) are expressed via PropertyValue entries on an additionalProperty array.

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

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

Highlight legend:Required by GoogleRecommendedOptional

schema.org/StatisticalPopulation

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "StatisticalPopulation",
  "@id": "https://xoocode.com/data/lackawanna-adults-25-34",
  "name": "Adults aged 25-34 resident in Lackawanna County",
  "populationType": "https://schema.org/Person",
  "numConstraints": 3,
  "additionalProperty": [
    { "@type": "PropertyValue", "propertyID": "age", "minValue": 25, "maxValue": 34 },
    { "@type": "PropertyValue", "propertyID": "residence", "value": "Lackawanna County, PA" },
    { "@type": "PropertyValue", "propertyID": "citizenship", "value": "US citizen or permanent resident" }
  ]
}
</script>

Minimal valid version

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

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "StatisticalPopulation",
  "name": "Adults aged 25-34 resident in Lackawanna County",
  "populationType": "https://schema.org/Person",
  "numConstraints": 3
}
</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 (used by statistical knowledge graphs)
Google docs

Common StatisticalPopulation 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
Constraints mis-counted
Wrong
```
numConstraints: 2 with 3 additionalProperty entries
```
Right
```
numConstraints must match the additionalProperty count
```
numConstraints is a verification signal; mismatch invalidates the population semantics.

Schema properties in this example

StatisticalPopulation Intangible name populationType Person numConstraints additionalProperty PropertyValue propertyID minValue maxValue value Observation

About the example data

Adults aged 25-34 resident in Lackawanna County — the population slice for the Dunmore labour-market dataset.

Comments

Loading comments...