PostalCodeRangeSpecification

PostalCodeRangeSpecification is a StructuredValue with two properties: postalCodeBegin (Text) and postalCodeEnd (Text). Used inside DefinedRegion.postalCodeRange to describe a contiguous range of postcodes served by an offer, shipping rule, or service.

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

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

schema.org/PostalCodeRangeSpecification

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "DefinedRegion",
  "addressCountry": "DK",
  "postalCodeRange": {
    "@type": "PostalCodeRangeSpecification",
    "postalCodeBegin": "1000",
    "postalCodeEnd": "2499"
  }
}
</script>

Minimal valid version

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

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "PostalCodeRangeSpecification",
  "postalCodeBegin": "1000",
  "postalCodeEnd": "2499"
}
</script>

Google rich results this unlocks

PostalCodeRangeSpecification 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). PostalCodeRangeSpecification becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

Common PostalCodeRangeSpecification 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
Listing each postcode separately
Wrong
```
Array of postalCode values
```
Right
```
Single PostalCodeRangeSpecification with begin + end
```
The StructuredValue is the canonical shape for contiguous ranges; arrays are for non-contiguous sets.

Schema properties in this example

PostalCodeRangeSpecification StructuredValue postalCodeBegin postalCodeEnd DefinedRegion addressCountry

Also mentioned in 1 other example

PostalCodeRangeSpecification also appears in DefinedRegion. See the full PostalCodeRangeSpecification schema page for every reference.

About the example data

Shipping zone for Xoo Code's Copenhagen-area same-day delivery — DK 1000–2499.

Comments

Loading comments...