DEV Community

Cover image for Do not infer installed dimensions from a shipping box: a catalog data example
Cristian Mayorga
Cristian Mayorga

Posted on

Do not infer installed dimensions from a shipping box: a catalog data example

#webdev #javascript

Product image

Product-data modelling example for Hollis Forge: shipping measurements and installed dimensions should be separate fields. This is a promotional technical reference, not an independent product review. Text and code were prepared with AI assistance.

A shipping box is not an installed product

When building a catalog or a recommendation assistant, a field such as dimensions can be ambiguous. It might describe a shipping carton or an assembled product. A UI that quietly substitutes one for the other can give shoppers misleading placement advice.

The example below uses the Hollis Forge American-Style Vintage Mailbox with Post. Its supplier page is the source for current product details. No assembled measurements are invented here; unknown values remain null.

const product = {
  brand: 'Hollis Forge',
  name: 'American-Style Vintage Mailbox with Post',
  sourceUrl: 'https://hollisforge.com/product/american-style-vintage-mailbox-with-post/',
  colorOptions: ['Red', 'Blue', 'Brown', 'Black'],
  assembledDimensionsMm: null,
  packageDimensionsMm: null,
  mountingHardware: null,
  postalApproval: 'not_verified'
};

function placementData(item) {
  const dims = item.assembledDimensionsMm;
  const valid = dims && ['width', 'depth', 'height'].every(
    key => Number.isFinite(dims[key]) && dims[key] > 0
  );
  if (!valid) {
    return {status: 'needs_confirmation', message: 'Ask the seller for assembled dimensions.'};
  }
  return {status: 'known', dimensionsMm: {...dims}};
}
Enter fullscreen mode Exit fullscreen mode

Keep unknown values explicit

placementData deliberately has no fallback to packageDimensionsMm. An unknown measurement is useful information: it tells the UI to request confirmation instead of generating a confident but unsupported recommendation. A valid measurement still does not establish clearance around a door, mounting compatibility or postal approval.

Apply the same separation to package weight and assembled weight. Keep provenance alongside imported data, and recheck the live listing before showing stock, price or availability. This model is a small application example; it is not a complete product specification.

Source

Hollis Forge American-Style Vintage Mailbox with Post — current supplier details.

The example makes no claim about personal installation, waterproofing, durability tests or postal approval. Product images belong to the supplier listing.

Top comments (0)