Overview
Inventory tracks how much of each item is in stock, at each location. An inventory record is one item at one location, with a set of stock levels. Inventory isn’t edited by hand — it’s driven by orders: as a sale, purchase, or transfer moves through its workflow, the relevant levels go up or down automatically. For the bigger picture, see the Commerce overview.A location is a kind of Content Instance —
a physical or virtual place (store, warehouse, distribution center) defined by
its content template.
Properties
An inventory record holds these levels for one item at one location:| Property | Type | Description |
|---|---|---|
location_id | reference | The location this stock is at. |
item_code_id | reference | The item (SKU) being tracked. |
on_hand | number | The quantity physically in stock. |
committed | number | The quantity reserved for orders (e.g. a sale not yet shipped). |
incoming | number | The quantity expected to arrive (e.g. a purchase or inbound transfer). |
returned | number | The quantity received back from customer returns, pending review. |
reorder_point | number | The threshold that signals it’s time to reorder. |
safety_stock | number | The minimum stock to keep in reserve. |
backordered | number | The quantity ordered but not yet fulfilled. |
available | number | Computed: on_hand − committed − safety_stock — what can be sold without dipping into safety stock. |
How stock changes
Stock isn’t set directly — it moves when an order changes status. Each order type affects different levels:| Order type | on_hand | committed | incoming | returned |
|---|---|---|---|---|
| Sale | ✓ | ✓ | ||
| Purchase | ✓ | ✓ | ||
| Transfer | ✓ (both locations) | ✓ (source) | ✓ (destination) | |
| Inventory adjustment | ✓ | |||
| Return (from a sale) | ✓ | |||
| Invoice / Pre-order / Opportunity / Shipping |
committed when it becomes New, then
moves it out of on_hand when Completed; voiding releases the reservation. See
Orders for the full lifecycle.
Serials
Items can be tracked per individual unit with serial numbers (enabled on the item’s content template). On order completion a serial is taken from the location’s pool; reversing a completion returns it. Transfers leave serials untouched.Managed inventory
Only items whose product is set to track stock have inventory. Items that don’t track stock skip all inventory effects entirely.Where to find it
You view stock levels in the Inventory view, under Commerce → Inventory. Inventory isn’t created or edited one record at a time, though — it’s a byproduct of orders. A purchase or an inventory adjustment is how stock first appears at a location.Seeds
Inventory isn’t seeded — stock comes from orders.Governance & permissions
Inventory isn’t edited directly by any role — it changes only through orders.Related
Orders
How orders move stock between levels.
Price Lists
Items, SKUs, and their prices.