Published at: 2026-09-17

Validation rules for multiple-unit conversions

Use this reference to understand conversion conditions, base-unit requirements, and variant item limits when saving multiple-unit products.

Conversion configuration

  • After you enable multiple units, a product can relate to multiple units of measure.
  • Conversion ratios must be unique within a product. This prevents duplicate conversion settings.
  • Each multiple-unit product must have at least one base unit before you can save it.
  • The unit object centrally manages unit data, including units such as boxes, packs, and pieces.

Maintenance entry points by mode

Scenario Maintains multiple units Product page behavior
Item disabled, multiple units disabled No multiple-unit configuration The product supports one unit only.
Item disabled, multiple units enabled Product The product page directly maintains units and conversions.
Item enabled, multiple units disabled Item maintains shared product unit information The product page cannot edit shared unit information separately.
Item enabled, multiple units enabled, nonvariant item Product The product can directly maintain multiple units.
Item enabled, multiple units enabled, variant item Item All related variant products share the item configuration. The product page only displays it.

Validate the configuration

After configuration, verify the multiple-unit entry for both a nonvariant item and a variant item:
  1. Open a product for a nonvariant item. Confirm that the product page can maintain multiple units according to permissions.
  2. Open a product for a variant item. Confirm that the product page displays the item’s multiple-unit information without a separate edit entry.
  3. Return to the item and update its multiple-unit configuration. Confirm that related variant products update.

Key validation term

The Duplicate Configuration check prevents repeated conversion ratios.

Related topics

Submit Feedback
Previous
Four configuration modes for items and multiple units