Units define the unit of measure used for inventory items and stock movements (e.g., box, piece, kg, L). Units ensure that quantities are consistent across receiving, issuing, reporting, label printing, and exports. Every item is assigned exactly one unit, and all movement quantities for that item are recorded in that unit.
Where you find it
Master data → Inventory → Units
What you see on this page
Left panel (filters & controls)
Search units: quickly locate a unit by name (e.g., “box”, “kg”).
Status tabs:
Active: units available for selection in item forms.
Disabled: units that are not available for new assignments.
Pagination size: e.g., “10 per page”
Reset: clears filters.
Units table (main area)
Unit: the unit name/label (e.g., box, carton, kg, ml).
Items: number of items currently using this unit.
On hand: total on-hand quantity aggregated across all items that use this unit.
Status: Active/Disabled.
Actions: context actions (edit/disable/enable) depending on permissions and configuration.
Primary action
Add unit: opens the unit creation form to add a new unit of measure.
How units work (practical rules)
Units are referenced by items. Once items exist, changing a unit can affect how users interpret quantities in movements and reports.
Disabling a unit is typically used when you want to stop using it for new items, while keeping historical data intact.
Typical workflow (recommended)
Create a small standardized set of units your business actually uses (piece, box, carton, kg, L, etc.).
Assign the correct unit to each item during item creation.
Keep units consistent to avoid confusion during receiving/issuing and when printing/exporting.
Best practices
Prefer singular, short unit names (piece, box, kg) to keep UI and printouts clean.
Avoid duplicate meanings (e.g., “pcs” and “piece”)—choose one convention and stick to it.
If you must replace a unit convention, create the new unit and start using it for new items rather than constantly renaming old units.
Troubleshooting
“I can’t select a unit when creating an item”: confirm the unit is Active (not Disabled).
“Totals in reports look inconsistent”: verify items are assigned to correct units; units do not convert automatically (e.g., 1 carton is not auto-converted to 24 pieces).