Units of Measure (UOM)

Liferay DXP 2023.Q4+/Portal 7.4 GA98+

Businesses can have different ways of maintaining and selling their stock. This is commonly known as Units of Measure (UOM). Some of the commonly used units of measure are

meter/centimeter/millimeter
ton/kilogram/gram
pallet/case/unit

Important

Units of Measure (UOM) was released behind a release feature flag in Liferay DXP 2023.Q4/Portal 7.4 GA98. It was made Generally Available (GA) in 2024.Q1/GA112.

You can define your own units of measure to manage, price, and sell your inventory by these defined units. You can also use UOM to sell stock in decimal quantities.

Units of measure link to SKUs. After creating the first unit of measure, all existing inventory and pricing information for the SKU gets mapped to the new unit.

Important

The first unit of measure you create adopts the pricing and inventory information related to the SKU. If you are introducing units of measure to previously traded SKUs, you must define the unit corresponding to the existing SKU first, and then create any additional UOMs.

Open the Global Menu () and navigate to Commerce → Products.
Select the product for the new unit of measure.
Go to the SKUs tab and select the SKU.
Select the Units of Measure (UOM) tab and click Add ().

Enter the given information to create a new unit called Bottle:

Unit of Measure: Bottle

Key: bottle

Decimal Allowed (Precision): 0

Base Unit Quantity: 1

Base Price: $12.99

Base Promotion Price: 0.00

Priority: 1

Purchasable: Enabled

Field	Description
Unit of Measure	Name of the unit of measure
Key	Unique key used to identify the unit of measure
Decimal Allowed (Precision)	Specifies the decimal increments by which you can purchase the SKU. Default value of 0 specifies decimal quantities are not allowed.
Base Unit Quantity	Specifies the increments by which you can purchase the SKU. Default value is 1.
Base Price	Base price of the unit
Base Promotion Price	Base promotion price of the unit
Priority	Determines the default unit selected on the product details page. The highest priority eligible purchasable unit of measure appears by default.
Purchasable	Toggle whether the unit is purchasable.

note

If you set the base unit quantity to a decimal value like 1.2, you must set the Decimal Allowed (Precision) field to 1. The number of decimal points in the Base Unit Quantity field must reflect in the Decimal Allowed (Precision) field for the unit to work correctly.