What Is transitTimeLabel Schema and Why Is It Retired?

Published
11 min read

Understand the retired transitTimeLabel property, how it matched Offers to DeliveryTimeSettings, timing conflicts, migration risks, ecommerce audits, and fixes.

What Is transitTimeLabel Schema?

transitTimeLabel is a retired Schema.org Text property that historically matched OfferShippingDetails with DeliveryTimeSettings inside a shippingSettingsLink cross-reference.

The label acted as a routing key for reusable delivery-time policies. An Offer-side value could identify which linked DeliveryTimeSettings entity supplied its deliveryTime information, separating faster, slower, regional, or service-specific timing groups.

The property did not define a number of days by itself. Its meaning depended on the settings it selected. Because transitTimeLabel and the linked DeliveryTimeSettings model are retired, existing values should be treated as migration evidence rather than a current architecture to expand.

  1. Identify the exact page, asset, entity or relationship described in this section.
  2. Inspect the live implementation and retain the observed evidence.
  3. Compare the observation with the intended meaning and its primary specification.
  4. Correct any mismatch, then retest the live result.
  5. Record the accountable owner and review date.
What Is transitTimeLabel Schema? reference table
CaseMeaningAction
transitTimeLabelRetired Text propertyAudit legacy use
OfferShippingDetailsHistorical parentMap Offer cohort
DeliveryTimeSettingsHistorical targetRetired and superseded
shippingSettingsLinkCross-reference contextRetired
Delivery durationSeparate policy factValidate independently
  • Record the raw label.
  • Find its intended settings entity.
  • Preserve the delivery-time outcome.
  • Do not add new unverified reliance.

Use the free backlink checker to identify linked product pages before changing shared delivery promises.

Primary specification: Schema.org definition for transitTimeLabel.

transitTimeLabel is legacy matching metadata whose intended Offer-to-delivery-time relationship must be preserved through migration.

Where Was transitTimeLabel Used?

transitTimeLabel was used on OfferShippingDetails to match a DeliveryTimeSettings entity in the historical linked-settings model.

Unlike shippingLabel, which matched rate settings, transitTimeLabel addressed delivery timing. It should not be attached directly to Product, Offer, ShippingRateSettings, ShippingDeliveryTime, QuantitativeValue, or DefinedRegion.

An audit needs both the source OfferShippingDetails and the intended DeliveryTimeSettings context even though the property page lists the Offer-side parent. Record merchant, linked resource, destination, service, timing group, and exact label value together.

  • 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
Where Was transitTimeLabel Used? reference table
CaseMeaningAction
OfferShippingDetailsListed parentContains legacy label
DeliveryTimeSettingsHistorical matched typeTiming policy
ShippingRateSettingsDifferent purposeRate policy
Product directWrong parentUse Offer structure
QuantitativeValueDuration valueNot a routing key
  1. Extract Offer-side values.
  2. Resolve the historical settings resource.
  3. Find candidate timing entities.
  4. Join within merchant and service scope.

Start with OfferShippingDetails and compare the separate shippingLabel rate-matching intent.

Correct placement and context keep a legacy timing selector distinct from the duration values and rate policies it helped route.

Why Are transitTimeLabel and DeliveryTimeSettings Retired?

transitTimeLabel is retired, and DeliveryTimeSettings is both retired and superseded by ShippingConditions in the current vocabulary.

This creates a clearer migration signal than a label status alone: the historical matching property and its destination type are no longer the current model. However, the supported target shape still depends on the consumer contract and the merchant's actual shipping architecture.

Do not translate labels mechanically into arbitrary IDs or copy timing numbers without context. Preserve destination, service, handling, transit, cutoff, business days, time zone, exceptions, and precedence, then express them through a verified supported representation.

  • 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
Why Are transitTimeLabel and DeliveryTimeSettings Retired? reference table
CaseMeaningAction
transitTimeLabelRetiredStop expansion
DeliveryTimeSettingsRetired and supersededPlan migration
ShippingConditionsSuperseding typeValidate target contract
Legacy consumerMay retain supportMeasure dependency
Timing factsBusiness truthPreserve all semantics
  1. Inventory legacy terms.
  2. Confirm the active consumer.
  3. Map facts into its supported contract.
  4. Test timing parity.
  5. Retain rollback evidence.

Retirement is handled correctly when the old matching layer is removed without changing any verified delivery promise.

How Exact Did transitTimeLabel Matching Need to Be?

transitTimeLabel should be audited as an exact text relationship because casing, whitespace, punctuation, encoding, locale suffixes, and template transformations can disconnect Offers from timing settings.

Standard, standard, standard-space, and US-standard may look related to an editor while behaving as separate keys in a parser. Multiple storefronts can also reuse a word with different delivery calendars, making text-only joins unsafe across merchant or market boundaries.

Preserve raw values before normalization. Compare candidate matches within the same merchant, settings resource, destination, service, and effective date, then use actual delivery-policy ownership to select a canonical migration identity.

  1. Identify the exact page, asset, entity or relationship described in this section.
  2. Inspect the live implementation and retain the observed evidence.
  3. Compare the observation with the intended meaning and its primary specification.
  4. Correct any mismatch, then retest the live result.
  5. Record the accountable owner and review date.
How Exact Did transitTimeLabel Matching Need to Be? reference table
CaseMeaningAction
Express vs expressCase driftTrace intended pair
standard plus spaceWhitespace driftFix serialization
US-2Day vs US_2DayPunctuation driftCanonicalize source
Same value, two merchantsScope collisionKeep merchant boundary
Locale suffix missingMarket collisionSeparate policies
  • Capture raw strings.
  • Generate normalized candidates.
  • Constrain matches by full context.
  • Repair identifiers at one authoritative source.

Text normalization is safe only after the intended timing relationship and its delivery outcome are proven.

What Delivery Facts Must Survive Migration?

Migration must preserve total delivery delay and every input that determines it, including handling time, transit time, business days, cutoff time, time zone, destination, service, holidays, weekends, product exceptions, and effective dates.

A promise of three to five business days can change if an order misses a cutoff, ships from another origin, contains backordered items, or crosses a holiday. Copying only the visible day range loses the rules that make the promise true.

Build a timing contract from order receipt to customer delivery. Test before and after cutoff, Friday orders, weekends, holidays, remote postal regions, multiple warehouses, preorder products, and expedited services.

  • 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
What Delivery Facts Must Survive Migration? reference table
CaseMeaningAction
Handling timeOrder to carrierPreserve range
Transit timeCarrier to customerPreserve range
Business daysCounting calendarPreserve weekdays
Cutoff and time zoneStart-time boundaryTest equality
Destination and serviceScopeKeep specific policy
  1. Define order-receipt timestamp.
  2. Apply cutoff and handling calendar.
  3. Apply transit calendar.
  4. Resolve exceptions.
  5. Compare promised delivery date.

A timing migration achieves parity only when the same order placed in the same context receives the same delivery window.

How Does isUnlabelledFallback Affect Timing Settings?

isUnlabelledFallback can mark unlabelled DeliveryTimeSettings intended as a default in the vocabulary's historical model, but true should not be combined with transitTimeLabel.

A labelled timing group represented specific selection, while an unlabelled fallback covered remaining Offers for the merchant. The fallback did not guarantee a fast delivery window; its deliveryTime and destination facts still determined the promise.

When migrating away from the retired model, preserve precedence. Product, seller, destination, service, stock, or expedited timing rules should win before the default timing policy is used.

  • 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
How Does isUnlabelledFallback Affect Timing Settings? reference table
CaseMeaningAction
Labelled timing groupSpecific historical selectionApply narrowly
Fallback trueUnlabelled defaultApply last
True plus transitTimeLabelMeaning conflictSeparate policies
Express timingSpecific serviceOverride standard
No safe matchUnknown promiseDo not invent
  1. Map specific timing cohorts.
  2. Map the unlabelled default.
  3. Detect true-plus-label conflicts.
  4. Prove specific timing wins.
  5. Test the remaining cohort.

Review isUnlabelledFallback for the shared default-selection concept and its retired-link caution.

Fallback timing stays honest when it remains unlabelled and never overrides a narrower delivery policy.

How Should You Migrate to ShippingConditions?

Migrate toward ShippingConditions by translating the supported timing, destination, availability, service, and rate facts required by the target consumer, then testing Offer-level parity before removing legacy labels.

ShippingConditions supersedes DeliveryTimeSettings in the current vocabulary, but a production migration still needs contract verification. Current OfferShippingDetails can also carry deliveryTime directly, and ShippingService can organize handling and conditions; choose the model your consumer demonstrably supports.

Start with one market and service cohort. Preserve stable Offer identities, render the target graph, validate it, test real order scenarios, compare delivery windows, and retain an immediate rollback until caches and downstream feeds converge.

  • 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
How Should You Migrate to ShippingConditions? reference table
CaseMeaningAction
Legacy DeliveryTimeSettingsSource modelArchive graph
ShippingConditionsSuperseding typeEvaluate target
Offer deliveryTimeCurrent direct optionVerify consumer
ShippingServiceService organizationPreserve scope
Cohort parityRelease gateCompare promises
  1. Choose the target consumer.
  2. Map every timing and scope fact.
  3. Render a controlled cohort.
  4. Test boundary orders.
  5. Scale after parity.

The historical URL context is covered in shippingSettingsLink migration.

A supported migration replaces retired matching while keeping every tested delivery window and exception unchanged.

What transitTimeLabel Mistakes Are Common?

Common mistakes include adding the retired label to new templates, mismatching text, duplicating timing groups, crossing merchant or market boundaries, combining a label with a true fallback, and treating the label name as a delivery promise.

Other defects include stale settings after warehouse changes, missing holiday calendars, cutoff times without time zones, settings pages that no longer render entities, redirects that alter resource identity, and syntax checks that never calculate an expected delivery date.

Repair the authoritative fulfillment and integration sources. Shared timing defects can affect entire product cohorts, so quantify exposure, prioritize falsely fast promises, stage the migration, and validate real dates instead of generic labels.

  1. Identify the exact page, asset, entity or relationship described in this section.
  2. Inspect the live implementation and retain the observed evidence.
  3. Compare the observation with the intended meaning and its primary specification.
  4. Correct any mismatch, then retest the live result.
  5. Record the accountable owner and review date.
What transitTimeLabel Mistakes Are Common? reference table
CaseMeaningAction
2-day labelIdentifier, not proofCalculate actual dates
Duplicate labelAmbiguous timingResolve ownership
Missing time zoneCutoff ambiguityAdd source context
True fallback plus labelSemantic conflictSeparate groups
Valid syntax, wrong dateBusiness mismatchRepair fulfillment data
  • Inventory raw values and settings.
  • Detect conflicts and orphaned groups.
  • Recalculate dates from policy inputs.
  • Repair shared sources.
  • Retest boundary orders.

transitTimeLabel defects are resolved only when the selected policy and the resulting customer delivery window both match fulfillment reality.