Units of Measure (UOM)

Units of measure define how products are quantified across purchasing, sales, and inventory. Every product has a base unit and can have additional conversion units for flexible ordering and pricing.

Core Concepts

Base Unit

Every product must have exactly one base unit. This is the fundamental unit used to track inventory and perform conversions. When you create a product, a default base unit is automatically assigned:

You can change the base unit at any time to match your product (e.g., "Kilogram" with unit "kg" for bulk goods).

Conversion Units

Additional units represent multiples of the base unit. For example, if your base unit is Piece (pcs), you can add:

The quantity field always represents how many base units make up one of the conversion unit.

Unit Field

The unit field (e.g., "pcs", "kg", "m") is shared across all units of a product. If you change the base unit's unit abbreviation, it updates on all conversion units automatically.

Unit Properties

Each unit has the following properties:

Managing Units

Setting Up the Base Unit

1. Open the product and go to the Cost & Units tab
2. If no base unit exists, click Add Unit — this opens the base unit form
3. Fill in the base unit details:
   • Name — e.g., "Kilogram"
   • Unit — e.g., "kg"
   • Quantity — typically 1 for the base unit
   • Sales Price — price per base unit
   • Cost — cost per base unit
   • Decimal — whether fractional quantities are allowed
4. Save

Updating the Base Unit

1. Click the edit action on the base unit row
2. Modify the fields as needed
3. Optionally enable Propagate price to other units:
   • When enabled, all conversion unit prices are proportionally adjusted
   • Example: If base unit price changes from 10 to 12 (1.2x), a Box priced at 100 becomes 120
4. Save

Adding Conversion Units

1. Click Add Unit (only available after a base unit exists)
2. Enter the conversion unit details:
   • Name — e.g., "Box"
   • Quantity — e.g., 12 (meaning 1 Box = 12 base units)
   • Sales Price — price per this unit
   • Cost — cost per this unit
   • Decimal — whether fractional quantities are allowed
3. Save

Deleting Units

• Click the delete action on any conversion unit
• The base unit cannot be deleted
• Unit names must be unique per product

Unit Display & Selection

In Orders and BOM

When selecting a product quantity in orders or bill of materials, the UOM selector shows:

• A number input for the amount
• A dropdown to choose which unit
• A badge showing the equivalent in base units

Example: Entering 2 Box shows a badge 24 pcs (because 1 Box = 12 pcs).

Info Popover

Hovering over the info icon next to the unit selector displays a popover with:

• All available units for the product
• An explanation of how units work
• A link to the product's unit settings for quick editing

Unit Table Sorting

The units table always displays the base unit first, followed by other units sorted by quantity (ascending). This makes it easy to see the unit hierarchy from smallest to largest.

Available Unit Types

The system supports the following standard unit types:

Conversion Examples

Weight-Based Product

Base unit: Kilogram (kg)

Packaged Product

Base unit: Piece (pcs)

Service Product

Base unit: Hour (hr)

How UOM Affects Other Modules

Related