How do I read and set units per carton, cartons per pallet and units per pallet through the External API?

Last updated: October 19, 2026

Products in the External API now include three pack-quantity fields:

  • units_per_carton

  • cartons_per_pallet

  • units_per_pallet

They are the same values you see in the product's shipping and packing details in the Luminous UI. A field is null if it has no value.

Reading

The fields appear when you fetch a product. They also appear in the cursor-based bulk product export, next to the existing carton and pallet dimensions.

Writing

Send any of the three fields when you create or update a product. Each must be a number of 0 or more, or null. For products with variants, you can send them on each entry in variants.