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.
- 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 |
|---|---|---|
| transitTimeLabel | Retired Text property | Audit legacy use |
| OfferShippingDetails | Historical parent | Map Offer cohort |
| DeliveryTimeSettings | Historical target | Retired and superseded |
| shippingSettingsLink | Cross-reference context | Retired |
| Delivery duration | Separate policy fact | Validate 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
| Case | Meaning | Action |
|---|---|---|
| OfferShippingDetails | Listed parent | Contains legacy label |
| DeliveryTimeSettings | Historical matched type | Timing policy |
| ShippingRateSettings | Different purpose | Rate policy |
| Product direct | Wrong parent | Use Offer structure |
| QuantitativeValue | Duration value | Not a routing key |
- Extract Offer-side values.
- Resolve the historical settings resource.
- Find candidate timing entities.
- 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
| Case | Meaning | Action |
|---|---|---|
| transitTimeLabel | Retired | Stop expansion |
| DeliveryTimeSettings | Retired and superseded | Plan migration |
| ShippingConditions | Superseding type | Validate target contract |
| Legacy consumer | May retain support | Measure dependency |
| Timing facts | Business truth | Preserve all semantics |
- Inventory legacy terms.
- Confirm the active consumer.
- Map facts into its supported contract.
- Test timing parity.
- 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.
- 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 |
|---|---|---|
| Express vs express | Case drift | Trace intended pair |
| standard plus space | Whitespace drift | Fix serialization |
| US-2Day vs US_2Day | Punctuation drift | Canonicalize source |
| Same value, two merchants | Scope collision | Keep merchant boundary |
| Locale suffix missing | Market collision | Separate 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
| Case | Meaning | Action |
|---|---|---|
| Handling time | Order to carrier | Preserve range |
| Transit time | Carrier to customer | Preserve range |
| Business days | Counting calendar | Preserve weekdays |
| Cutoff and time zone | Start-time boundary | Test equality |
| Destination and service | Scope | Keep specific policy |
- Define order-receipt timestamp.
- Apply cutoff and handling calendar.
- Apply transit calendar.
- Resolve exceptions.
- 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
| Case | Meaning | Action |
|---|---|---|
| Labelled timing group | Specific historical selection | Apply narrowly |
| Fallback true | Unlabelled default | Apply last |
| True plus transitTimeLabel | Meaning conflict | Separate policies |
| Express timing | Specific service | Override standard |
| No safe match | Unknown promise | Do not invent |
- Map specific timing cohorts.
- Map the unlabelled default.
- Detect true-plus-label conflicts.
- Prove specific timing wins.
- 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
| Case | Meaning | Action |
|---|---|---|
| Legacy DeliveryTimeSettings | Source model | Archive graph |
| ShippingConditions | Superseding type | Evaluate target |
| Offer deliveryTime | Current direct option | Verify consumer |
| ShippingService | Service organization | Preserve scope |
| Cohort parity | Release gate | Compare promises |
- Choose the target consumer.
- Map every timing and scope fact.
- Render a controlled cohort.
- Test boundary orders.
- 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.
- 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 |
|---|---|---|
| 2-day label | Identifier, not proof | Calculate actual dates |
| Duplicate label | Ambiguous timing | Resolve ownership |
| Missing time zone | Cutoff ambiguity | Add source context |
| True fallback plus label | Semantic conflict | Separate groups |
| Valid syntax, wrong date | Business mismatch | Repair 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.