Weighted Items
Weighted items are sold by weight, either because the customer selects a count (for example,
bananas) but is charged by actual weight, or because the customer selects a weight directly (for
example, deli meat). An item is weighted when WEIGHTED is present in product_traits and the
weighted_item_info object describes how it is measured, shopped, and priced. A prepackaged item
whose weight varies pack to pack is still a weighted item — see
Measured by each, sold by weight.
For items sold as discrete units, see Unit Items.
Where Pricing Is Set
Prices are never set on the catalog item. Every field in weighted_item_info names a unit, not
an amount. The amount is a separate request to the Inventory API, per store:
| Request | Endpoint | Carries |
|---|---|---|
| Catalog | POST /marketplace/api/v2/items | product_traits, weighted_item_info — how the item is measured, shopped, and priced by |
| Inventory and pricing | POST /marketplace/api/v2/stores/{store_location_id}/items | price_info — the actual amount, in cents |
Each item type below shows both requests. Inventory API price fields for weighted items:
| Parameter Name | Type | Description |
|---|---|---|
| base_price_per_measurement_unit | integer | Price in cents per measurement unit, for example 69 for $0.69 per the unit named in price_by_measurement_unit |
| sale_price_per_measurement_unit | integer | Promotional price in cents per measurement unit |
| loyalty_price_per_measurement_unit | integer | Loyalty price in cents per measurement unit |
All values are integers in cents; a decimal such as 4.50 returns
Instance type (number) does not match any allowed primitive type (allowed: ["integer"]). For a
weighted item, use the per-measurement-unit fields rather than base_price — see
Inventory and Pricing Reference.
Item Types
Four setups cover how retail items are picked, sold, and priced. The first is not a weighted item
and is included for contrast — everything after it is. Each setup determines the purchase_type
DoorDash sends on the order line item, and what the customer sees on the storefront. See
Support Weighted Items via Merchant Pick for the
order-side contract.
Picked and sold by each
Not a weighted item. The customer buys a discrete unit at a fixed price. purchase_type: UNIT.

Omit WEIGHTED and omit weighted_item_info.
Catalog API — POST /marketplace/api/v2/items
{
"merchant_supplied_item_id": "item-milk-001",
"name": "Whole Milk",
"product_traits": [],
"size": {
"details": {
"product_specific_size_definition": {
"value": "1",
"description": "gal"
}
}
}
}
Inventory API — POST /marketplace/api/v2/stores/{store_location_id}/items
{
"merchant_supplied_item_id": "item-milk-001",
"item_availability": "ACTIVE",
"price_info": {
"base_price": 299
}
}
base_price is the amount the customer pays for one unit — 299 renders as $2.99.
Picked by each, sold by weight
The customer selects a count, and is charged by the weight actually picked — loose produce is the
common case. purchase_type: UNIT_TO_MEASUREMENT.

Catalog API — POST /marketplace/api/v2/items
{
"merchant_supplied_item_id": "item-banana-001",
"name": "Banana",
"product_traits": ["WEIGHTED"],
"weighted_item_info": {
"average_weight_per_each": 0.5,
"average_weight_measurement_unit": "lb",
"shop_by_measurement_unit": "ea",
"price_by_measurement_unit": "lb"
}
}
Inventory API — POST /marketplace/api/v2/stores/{store_location_id}/items
{
"merchant_supplied_item_id": "item-banana-001",
"item_availability": "ACTIVE",
"price_info": {
"base_price_per_measurement_unit": 69
}
}
base_price_per_measurement_unit is $0.69/lb. The storefront multiplies it by average_weight_per_each for the per-each estimate: 0.5 lb at $0.69/lb displays as $0.35/ea. An inaccurate average_weight_per_each makes that estimate wrong.