Understanding units of measurement (weight, volume, count, packaging)
The unit you assign to an inventory item controls how Stash counts it, how Blueprints deduct it, and how POS sales update stock. Picking the right unit at the start saves a lot of cleanup later.
Stash supports four unit families. Pick the one that matches how you actually store and count the item — not how a supplier ships it or how a customer buys it.
The four unit families
Weight
Use weight when you store and use the item by mass — flour, coffee beans, deli meat, sugar, raw ingredients sold loose.
Available units: Milligram, Gram, Ounce, Kilogram, Pound (Ton and Metric Ton also supported for warehousing).
Stash converts between weight units automatically — a Blueprint can ask for 18 Gram from an item stored in Kilogram and the math just works.
Volume
Use volume for liquids and anything you measure by capacity — milk, syrup, oil, wine, cleaning solutions.
Available units: Milliliter, Teaspoon, Tablespoon, Fluid Ounce, Cup, Pint, Quart, Liter, Gallon.
Stash converts between volume units automatically.
Count
Use count for whole, individual things — t-shirts, books, candles, mugs, pieces of fruit, individual buns.
Available units: Each, Piece, Units.
These are the simplest. One unit = one thing.
Packaging
Use packaging when the item is stored as a container that holds something inside — a 1kg bag of beans, a 750ml bottle of wine, a case of 24 cans, a box of 12 muffins, a sachet of sugar.
Available units: Bag, Bottle, Box, Can, Carton, Case, Crate, Drum, Barrel, Container, Tub, Tray, Set, Dozen, Jar, Sachet, Bundle, Pallet, Reel, Roll, Sheet, Scoop.
Packaging units are the most powerful but require one extra setup step: telling Stash how much is inside one container. See How "Each container contains" works for the full explanation.
How conversions work
Stash converts within a family but not across families. So:
✅ Gram → Kilogram (both weight)
✅ Milliliter → Liter (both volume)
❌ Gram → Milliliter (different families — you'd need a density value, which Stash doesn't track)
❌ Each → Liter (different families)
If you build a Blueprint with mismatched units, you'll see a "Cannot convert" warning on the deduction preview. Either change the component unit or fix the inventory item's unit. See Why my Blueprint isn't deducting stock.
Crossing families with packaging
The exception: if your item is stored in a packaging unit and you've filled in Each container contains, Stash can convert across families. Example:
Item: Coffee Beans, stored in
Bag, with Each Bag contains =1000 GramBlueprint component:
18 GramStash deducts
0.018 Bagper sale ✅
This is how Blueprints work for real-world recipes where you measure in grams or millilitres but stock in bags or bottles.
Choosing a unit — quick guide
You stock and count by… | Use unit |
Mass (grams, pounds) | Weight family |
Volume (mL, L) | Volume family |
One-off whole items | Each / Piece / Units |
Containers with measurable content (a 1kg bag, a 750ml bottle) | Packaging unit + content quantity |
Containers with a fixed pack count (a case of 24) | Packaging unit + pack size |
Changing an item's unit later
You can change the unit on an existing item at any time. If the item is used in Blueprints, double-check the deduction previews afterwards — a unit change might invalidate the conversion. Stash will warn you on any affected Blueprint.
Decimal separator
Stash uses a period (.) for decimals everywhere — so 0.5 Liter, not 0,5 Liter. This is consistent across all locales.
Related articles