Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

Units of measure

Describes units of measure and how to use them in Optimizely Configured Commerce.

Work with units of measure

Optimizely Configured Commerce allows users to purchase in multiple units of measure (UoM's) and the system automatically adapts to the pricing and inventory implications of these alternate units. Base units of measure are set at the Product level. The value in the Unit of Measure field is displayed next to the product only if the Unit of Measure Description is left blank. If a description is provided in the Unit of Measure Description field, then that description is displayed in place of the value in the Unit of Measure field.



Configured Commerce does not support alternate units of measure on any configured products

Multiple units of measure

Multiple/Alternate UoM's work by grouping a number of the base UoM's into another package. For example, a base product may be 1 container, with alternate units of measure being a box of 12 containers, and a case of 24 containers.

Applicable settings

Multiple Units of Measure will only appear on a website if the Alternate Units of Measure Setting is set to ON. The default for this setting is OFF

  1. Go to Admin Console > Administration >�System > Settings.
  2. Enter Alternate Units of Measure in the search box.
  3. Change the toggle to display On.
  4. Click Save.

Set a product to use alternate units of measure

This section covers the steps necessary to set a product to use Alternate Units of Measure. These settings are found in Catalog > Products

  1. Find the desired product and click Edit.
  2. Click the Alternate Units of Measure finger tab.
  3. Click Add Alternate Unit of Measure.
  4. Enter the information for the Alternate Units of Measure.
  5. Click Save.

Alternate units of measure field reference

Column Name



This field is the unit of measure. It typically is an abbreviation for the specified unit of measure. It appears to the right of the product price only if the Description field is not populated. If the Description field is populated, it will display in place of the U/M field content. If left blank, no alternate units of measure will display.


This field is the description that, if populated, displays on the website next to the price and within the alternate unit of measure selector.


This field defines how many of the base unit of measure comprise the alternate unit of measure. The base unit of measure is set on the Details tab of the product.

Rounding Rule


No Rounding -This rule allows fractional quantities of this product to be ordered. This is the default rule.

Round - This rule will round a fractional quantity up or down, based on which integer the fractional quantity is closer to (e.g., 1.25 = 1, 1.75 = 2).

Round Up - This rule will round any fractional quantity up to the next integer (e.g., 1.01 = 2)

Multiple Only - This rule will round the quantity to the closest multiple of the number set in the MultipleSaleQty field on the Details Tab of the product (e.g., MultipleSaleQty = 3, qty ordered = 6, value = 6; qty ordered = 7, value = 9)

DefaultIf Yes is selected, this UoM will show on the website by default.

Warehouse inventory behavior when working with alternate units of measure

When purchasing products with alternate units of measure, the quantity on order will increment by the quantity purchased * quantity per UoM.