What Is weight in ShippingConditions?

Published
11 min read

Learn how weight models shipping thresholds with Mass or QuantitativeValue, LBR and KGM units, min/max ranges, dimensional weight, freight, audits, and fixes.

What Is weight in ShippingConditions?

weight is a Mass or QuantitativeValue that limits a ShippingConditions rule to products or shipments within a specified weight measurement or range.

It can separate parcel rates, heavy-item surcharges, freight eligibility, and unavailable routes. The property determines when the surrounding shipping condition applies; it does not state the shipping charge or calculate carrier billable weight by itself.

A useful rule needs a numeric value or min/max range and an explicit unit. The measurement must match the operational weight used by checkout, including any packaging or shipment aggregation policy defined by the merchant.

  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 weight in ShippingConditions? reference table
CaseMeaningAction
weightMass constraint0–50 lb
MassExpected value typeWeight measurement
QuantitativeValueStructured measurementRange and unit
minValueLower boundary50
maxValueUpper boundary70
  • Define the measured object.
  • Use an explicit unit.
  • Match the checkout authority.

Use the free backlink checker to identify linked product pages before changing heavy-item shipping promises.

Primary specification: Schema.org definition for weight.

weight is accurate when its measurement selects exactly the shipments receiving the surrounding rule.

Where Does weight Belong?

weight belongs on ShippingConditions when it constrains a reusable shipping rule, and it can also appear on Product or OfferShippingDetails for other weight intents.

Parent context determines meaning. Product weight describes the item. OfferShippingDetails weight can describe an Offer's shipping detail. ShippingConditions weight defines the measurement band where a rate, transit time, or exclusion applies.

Do not copy one Product value into every condition without considering quantity, packaging, or split shipments. ShippingService reaches the conditional property through shippingConditions.

  • 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 Does weight Belong? reference table
CaseMeaningAction
ShippingConditionsRule thresholdRate or eligibility band
ProductItem measurementProduct fact
OfferShippingDetailsOffer shipping detailOffer context
ShippingService → conditionsReusable route ruleCorrect path
  1. Identify product fact or rule threshold.
  2. Choose the correct parent.
  3. Add measurement and unit.
  4. Connect destination and outcome.
  5. Validate the graph.

Review ShippingConditions for the parent rule.

Correct placement distinguishes an item's weight fact from a weight-based shipping condition.

Should You Use Mass or QuantitativeValue?

Use Mass or QuantitativeValue according to the source model, with QuantitativeValue especially useful when minValue, maxValue, value, unitCode, or unitText must be explicit.

A single exact measurement can use value plus a unit. A tier needs minValue and maxValue. Keep numeric fields as numbers and avoid packing a range such as 10–20 lb into one unstructured string when structured boundaries are available.

The choice should remain consistent across product data, shipping rules, and audit tooling. A parser that understands QuantitativeValue can compare units and boundaries more reliably than free text.

  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.
Should You Use Mass or QuantitativeValue? reference table
CaseMeaningAction
Exact 10 lbvalue plus LBRSingle measurement
10–20 lbminValue and maxValueRange
10-20 lbs textHard to validateUse structured fields
Mass nodeValid weight typePreserve source model
  • Choose exact value or range.
  • Keep numeric values numeric.
  • Supply a recognized unit.
  • Test serialization.

Structured weight values are strongest when number, range, and unit remain independently machine-readable.

Which Weight Units Should US Shipping Use?

US shipping conditions should use a consistent unit vocabulary, commonly LBR for pounds or KGM for kilograms, and must convert values before comparing thresholds.

Never compare 50 pounds with 50 kilograms as if they are equal. UnitText such as lb or kg can aid readability, while a controlled unitCode supports consistent joins. Ounces may require their own supported unit representation and exact conversion policy.

Choose the unit used by the rate engine or normalize all source measurements to one canonical unit with documented precision. Preserve the original measurement for evidence, and round only where checkout does.

  • 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
Which Weight Units Should US Shipping Use? reference table
CaseMeaningAction
LBRPoundCommon US unit
KGMKilogramInternational unit
lb textReadable labelKeep code consistent
Missing unitAmbiguous numberReject
Converted thresholdPrecision riskMatch checkout rounding
  1. Select one comparison unit.
  2. Convert before evaluating ranges.
  3. Document rounding precision.
  4. Retain source values.
  5. Test threshold edges.

A weight threshold is interpretable only when its unit and conversion behavior are explicit and consistent.

How Do minValue and maxValue Define Weight Tiers?

minValue and maxValue define the lower and upper weight boundaries for which a ShippingConditions rule applies.

A parcel tier can cover zero through 50 pounds, an oversize parcel tier more than 50 through 70 pounds, and freight above 70 pounds. Actual boundary choices must follow the merchant's carrier and fulfillment configuration.

Document whether endpoints are included and avoid gaps or overlaps for the same service and destination. Test immediately below, exactly at, and immediately above each threshold using the same measurement precision and rounding as checkout.

  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 Do minValue and maxValue Define Weight Tiers? reference table
CaseMeaningAction
0–50 LBRStandard parcelTest 49.99 and 50
>50–70 LBRHeavy parcelTest 50.01 and 70
>70 LBRFreightTest 70.01
Overlap at 50Two rates matchRepair inclusivity
Gap after 70No serviceAdd rule or exclusion
  • Define carrier boundaries.
  • Set consistent units.
  • Document endpoint behavior.
  • Test three points per threshold.

Weight tiers are dependable when every measured shipment resolves to one intentional band.

How Do Actual and Dimensional Weight Interact?

Actual and dimensional weight should follow the carrier's billable-weight logic, while structured shipping conditions must avoid claiming a simple mass threshold when dimensions can change the outcome.

A light but bulky package can be billed above its scale weight. The weight property does not calculate dimensional weight automatically; width, height, and depth can provide separate condition context, and the merchant's rate engine remains the authority for billable measurement.

If checkout uses the greater of actual and dimensional weight, document that calculation in the source policy. Test dense, lightweight-bulky, and multi-package products. Do not label a dimensional result as actual physical mass.

  • 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 Do Actual and Dimensional Weight Interact? reference table
CaseMeaningAction
Dense packageActual may governScale evidence
Light bulky packageDimensional may governDimensions and divisor
Missing dimensionsBillable weight uncertainInvestigate
Several packagesPer-package calculationAvoid naive total
Dimensional resultBilling measureDo not call actual mass
  1. Capture actual weight.
  2. Capture package dimensions.
  3. Apply the checkout formula.
  4. Preserve measurement meaning.

Weight-based markup remains truthful when actual mass and dimensional billing logic are not conflated.

How Does Weight Interact With Quantity and Destination?

weight, numItems, destination, orderValue, dimensions, and product scope can jointly constrain one ShippingConditions rule, and every specified condition must match.

Five lightweight units may remain parcel eligible while five heavy units require freight. The same 60-pound item may ship within the contiguous US but not to Alaska. A high cart value does not automatically override a carrier weight restriction.

Build a decision matrix across quantity, aggregated shipment weight, route, subtotal, and product cohort. Test intersections rather than validating each property alone.

  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 Does Weight Interact With Quantity and Destination? reference table
CaseMeaningAction
5 items, 20 lbParcel tierCount and weight match
5 items, 100 lbFreight tierWeight changes outcome
60 lb to CaliforniaHeavy parcel possibleDestination matters
60 lb to AlaskaPossible exclusionRoute matters
High-value heavy cartStill restrictedValue is separate
  • List all condition dimensions.
  • Define aggregation behavior.
  • Generate intersection carts.
  • Resolve one service outcome.

Compare numItems, orderValue, and shippingDestination.

Combined conditions are coherent when count, weight, value, and geography resolve together without gaps.

What weight Schema Mistakes Are Common?

Common mistakes include missing units, mixing pounds and kilograms, using net product weight instead of packed shipment weight, reversed bounds, gaps or overlaps, stale carrier thresholds, and checkout mismatches.

Other defects include ignoring dimensional weight, summing multi-package shipments incorrectly, applying one variant's weight to every Offer, and treating a syntax-valid measurement as operational proof. A value can be technically valid but commercially false.

Weight defects often originate in shared catalog or fulfillment data. Repair the authoritative measurement and packaging logic, then regenerate affected pages and conditions.

  • 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 weight Schema Mistakes Are Common? reference table
CaseMeaningAction
50 without unitAmbiguous thresholdAdd unit
LBR compared with KGMWrong tierConvert first
Net instead of packedUnderquoted rateUse shipping measure
Variant inheritanceWrong product cohortValidate each Offer
Old carrier limitStale serviceSync policy
  1. Extract every weight and parent.
  2. Normalize units for analysis.
  3. Find boundary gaps and overlaps.
  4. Compare packed checkout weights.
  5. Repair the source.

weight defects require measurement, unit, packaging, range, route, and checkout validation together.