Published at: 2026-09-17
Set multiple units and conversion rules for a product
When only the multiple-Unit feature is enabled, associate multiple Units with a Product and set the conversion rules between them.
Applicable scenario
Set multiple Units when a Product uses different Units in different business scenarios, such as beverages sold by the case and bottle or building materials measured in tons and kilograms.
Before you start
[!IMPORTANT] - Prerequisite configuration: The administrator has enabled multiple Units and has not enabled the Item feature. - Basic information: Prepare the Product, Units, and conversion ratios. - Entry point: Open the Products module and create or edit a Product.
Procedure
- In the Products module, click New Product or open the Product to maintain.
- On the Product page, enable Multiple Units?.
- In the Unit section, add the Units used by the Product.
- Set the conversion rules between Units.
- Select and maintain a Base Unit.
- Confirm that conversion ratios do not contain a Duplicate Configuration. The system validates conversion-ratio uniqueness.
- Click Save.
Expected results
- The Product is associated with multiple Units.
- The Product saves the conversion rules between Units.
- The Product can use the configured Units in business documents such as Quotes, Sales Orders, and Sales Contracts.
- Conversion ratios for the same Product remain unique.
- The Product has at least one Base Unit.
- Product Price is returned according to the selected Unit and applicable Price Book.
[!WARNING] When both the Item and multiple-Unit features are enabled, the Item centrally maintains multiple Units for a variant Item, and the Product page cannot edit them independently. Follow Create a Product for a Variant Item.