What Is addressRegion in DefinedRegion?
addressRegion identifies the state, province, or comparable first-level administrative division inside a DefinedRegion.
Its value may be Text or AdministrativeArea. In US shipping markup, a two-letter state code such as CA or NY gives a concise state-level region when paired with addressCountry US. The DefinedRegion can then act as a shipping destination or origin.
The property defines geographic membership; it does not state a rate, delivery time, or service. Those outcomes belong to the surrounding shipping detail or condition. Use state scope only when the outcome truly applies across the entire state.
- Identify the exact page, asset, entity or relationship described in this section.
- Inspect the live implementation and retain the observed evidence.
- Compare the observation with the intended meaning and its primary specification.
- Correct any mismatch, then retest the live result.
- Record the accountable owner and review date.
| Case | Meaning | Action |
|---|---|---|
| addressRegion | First-level division | CA |
| addressCountry | Country context | US |
| DefinedRegion | Geographic parent | US-CA |
| shippingDestination | Possible use | State coverage |
- Pair the region with its country.
- Use consistent region codes.
- Verify statewide operational coverage.
Use the free backlink checker to locate linked product and policy pages before editing shipping coverage.
Primary specification: Schema.org definition for addressRegion.
addressRegion is accurate when one first-level division shares the represented shipping outcome.
Where Does addressRegion Belong?
addressRegion belongs on DefinedRegion for shipping coverage or on PostalAddress for an actual address, and the two intents should not be confused.
A shipping Destination or origin reaches the property through DefinedRegion. A customer, seller, or facility address can use it through PostalAddress. Publishing a state-level coverage rule does not require a street address, locality, or private warehouse details.
Do not attach addressRegion directly to Product, Offer, ShippingService, or ShippingConditions without the appropriate region or address parent. Correct nesting allows consumers to distinguish geographic eligibility from a physical mailing location.
- The exact page, asset, entity or relationship covered by this section
- The live implementation rather than an editor-only preview
- The primary specification or first-party record defining the expected behavior
- The validation result, accountable owner and review date
| Case | Meaning | Action |
|---|---|---|
| DefinedRegion | Coverage membership | Shipping rule |
| PostalAddress | Physical address | Entity location |
| Product direct | No expected path | Do not use |
| ShippingConditions via DefinedRegion | Rule context | Correct nesting |
- Identify coverage or address intent.
- Choose DefinedRegion for shipping scope.
- Add country and region.
- Connect the shipping entity.
- Validate the graph.
Review DefinedRegion in shipping schema for the geographic parent.
Correct placement keeps state-level coverage separate from a business or customer address.
Should US States Use Names or Two-Letter Codes?
US shipping regions can use Text, but one consistent two-letter state-code vocabulary is usually easier to validate, join, deduplicate, and compare with checkout.
Mixing CA, California, and Calif. creates separate strings for the same state. A controlled code set reduces ambiguity and supports direct comparisons with carrier and tax data. Whatever representation is chosen must remain paired with addressCountry US.
Do not assume a two-letter value is globally unique. CA can be misread without country context. Normalize in the source system, preserve the original evidence during audits, and prevent templates from emitting multiple synonyms for one region.
- Identify the exact page, asset, entity or relationship described in this section.
- Inspect the live implementation and retain the observed evidence.
- Compare the observation with the intended meaning and its primary specification.
- Correct any mismatch, then retest the live result.
- Record the accountable owner and review date.
| Case | Meaning | Action |
|---|---|---|
| CA + US | Clear US state | Preferred controlled form |
| California + US | Readable Text | Normalize consistently |
| Calif. | Uncontrolled abbreviation | Avoid |
| CA without country | Ambiguous | Add addressCountry |
- Select one canonical vocabulary.
- Map known synonyms.
- Require country context.
- Reject unknown codes.
- Test rendered values.
A US state representation is reliable when it is consistent, country-qualified, and shared with the shipping engine.
When Should You Use State-Level Shipping Coverage?
Use state-level coverage when every address in that state receives the same shipping availability, rate, timing, and product treatment under the represented rule.
State scope is compact and maintainable for broad domestic services. It becomes false when remote ZIPs, islands, metro-only delivery, carrier zones, or product restrictions create exceptions inside the state. In those cases, add narrower postal rules or split the shipping conditions.
Do not publish a state simply because the checkout form accepts the state name. Acceptance is not proof that every ZIP is serviceable. Test representative urban, rural, border, remote, and known-exception postal codes.
- The exact page, asset, entity or relationship covered by this section
- The live implementation rather than an editor-only preview
- The primary specification or first-party record defining the expected behavior
- The validation result, accountable owner and review date
| Case | Meaning | Action |
|---|---|---|
| Uniform statewide service | addressRegion | Compact truthful rule |
| One ZIP excluded | State plus exact exception | Preserve narrow block |
| Continuous partial zone | postalCodeRange | Use endpoints |
| Scattered service area | Exact codes or ranges | Preserve gaps |
| Metro-only delivery | Postal coverage | State is too broad |
- Confirm statewide membership.
- Find ZIP-level exceptions.
- Compare rates and times.
- Choose the least detailed truthful region.
State-level coverage is appropriate only when no important in-state address contradicts the promise.
How Do Multi-State Shipping Regions Work?
Multi-state coverage should use multiple DefinedRegion values or clearly grouped conditions when several states share the same shipping outcome.
Do not combine state codes into one comma-separated addressRegion string. Each region value should remain machine-distinguishable. States can share one service condition when their rates, times, restrictions, and product eligibility are equivalent.
If one state later receives a surcharge or slower transit time, separate it from the cohort rather than adding contradictory duplicate rules. Grouping is a maintenance decision after geographic truth, not a reason to hide operational differences.
- Identify the exact page, asset, entity or relationship described in this section.
- Inspect the live implementation and retain the observed evidence.
- Compare the observation with the intended meaning and its primary specification.
- Correct any mismatch, then retest the live result.
- Record the accountable owner and review date.
| Case | Meaning | Action |
|---|---|---|
| CA, OR, WA same outcome | Multiple regions | Shared condition possible |
| AK different rate | Separate region | Distinct outcome |
| HI product restriction | Separate condition | Offer or product scope |
| NY and NJ local delivery | Two DefinedRegions | Keep values distinct |
- List each state independently.
- Compare complete shipping outcomes.
- Group only equivalent states.
- Split cohorts when policy changes.
Multi-state rules are coherent when each state is explicit and every grouped member shares the same outcome.
How Do State Rules Interact With ZIP Exceptions?
A specific postalCode, postalCodePrefix, or postalCodeRange rule should resolve predictably against a broader addressRegion rule using documented precedence.
A state may receive standard ground shipping while one remote ZIP has a surcharge, one postal interval has slower transit, and another code cannot ship. Without specificity rules, the same destination can match several contradictory conditions.
Treat the state as the default and narrower postal membership as an exception only when that matches checkout. Test the exception and neighboring ZIPs that should retain the state outcome. Array order alone is not a durable precedence system.
- The exact page, asset, entity or relationship covered by this section
- The live implementation rather than an editor-only preview
- The primary specification or first-party record defining the expected behavior
- The validation result, accountable owner and review date
| Case | Meaning | Action |
|---|---|---|
| State rule | Broad default | Lower specificity |
| Postal range | Zone exception | Narrower |
| Postal prefix | Text-family exception | Validate match set |
| Exact postalCode | Single-code exception | Most specific |
| Duplicate narrow rules | Conflict | Repair authority |
- Enumerate all matching regions.
- Rank documented specificity.
- Resolve one outcome.
- Test exception boundaries.
- Add regression cases.
Compare exact postalCode, postalCodePrefix, and postalCodeRange.
State and postal rules work together when every address resolves to one deterministic shipping promise.
How Does addressRegion Affect Rates and Delivery Times?
addressRegion affects shipping by selecting the state-level DefinedRegion whose surrounding condition provides the applicable rate, delivery time, service, or exclusion.
The state value itself carries no price or duration. Alaska may use a different service than California, while neighboring states can share one ground-delivery band. Keep every outcome tied to the same active rate and fulfillment authority used by checkout.
When state policy changes, test several ZIPs across the state rather than one capital-city address. Also test any narrower exception rules. This prevents a broad update from erasing remote surcharges, local delivery areas, or product restrictions.
- Identify the exact page, asset, entity or relationship described in this section.
- Inspect the live implementation and retain the observed evidence.
- Compare the observation with the intended meaning and its primary specification.
- Correct any mismatch, then retest the live result.
- Record the accountable owner and review date.
| Case | Meaning | Action |
|---|---|---|
| Contiguous state | Base ground service | Rate table |
| Alaska | Special service or exclusion | Route evidence |
| Hawaii | Distinct rate or time | Carrier policy |
| State with ZIP exception | Broad plus narrow rules | Precedence test |
| Origin state | Dispatch route effect | Facility evidence |
- Resolve state membership.
- Apply the surrounding condition.
- Test in-state samples.
- Compare final checkout output.
Use shippingOrigin when the state describes dispatch rather than delivery.
State-level shipping promises remain truthful when rates and timing are verified across the whole represented region.
What addressRegion Schema Mistakes Are Common?
Common mistakes include missing country context, mixed state names and codes, invalid abbreviations, assuming statewide coverage, confusing a PostalAddress with a DefinedRegion, conflicting postal exceptions, and stale service areas.
Another defect is treating territories as ordinary states without checking the actual fulfillment rule. APO and FPO addresses also require carrier-specific evidence. Syntactically valid Text cannot prove that a state code is correct or that every address in that state is eligible.
Broad state errors can affect thousands of product pages. Repair the shared geographic source rather than patching rendered entities one by one, then verify that narrower postal exceptions survive regeneration.
- The exact page, asset, entity or relationship covered by this section
- The live implementation rather than an editor-only preview
- The primary specification or first-party record defining the expected behavior
- The validation result, accountable owner and review date
| Case | Meaning | Action |
|---|---|---|
| CA without US | Ambiguous region | Add country |
| CA and California mixed | Duplicate membership | Normalize vocabulary |
| Statewide assumption | False coverage | Test ZIP cohorts |
| Territory grouped blindly | Wrong service | Use operational evidence |
| Stale state rule | Wrong promise | Sync policy |
- Extract state values and parents.
- Normalize for analysis.
- Find duplicate and conflicting rules.
- Sample statewide ZIPs.
- Repair the source.
addressRegion defects require vocabulary, geography, precedence, and checkout validation together.