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

## Work with units of measure

Optimizely <<product-name>> 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.


<<product-name>> 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

<table class="TableStyle-Borders" style="margin-left: 0; margin-right: auto; width: 100%;" data-cellspacing="0"> <thead> <tr class="header TableStyle-Borders-Head-Header1"> <th class="TableStyle-Borders-HeadE-Regular-Header1"><p>Column Name</p></th> <th class="TableStyle-Borders-HeadD-Regular-Header1"><p>Description</p></th> </tr> </thead> <tbody> <tr class="odd TableStyle-Borders-Body-Row1"> <td class="TableStyle-Borders-BodyE-Regular-Row1"><p><strong>U/M</strong></p></td> <td class="TableStyle-Borders-BodyD-Regular-Row1"><p>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.</p></td> </tr> <tr class="even TableStyle-Borders-Body-Row1"> <td class="TableStyle-Borders-BodyE-Regular-Row1"><p><strong>Description</strong></p></td> <td class="TableStyle-Borders-BodyD-Regular-Row1"><p>This field is the description that, if populated, displays on the website next to the price and within the alternate unit of measure selector.</p></td> </tr> <tr class="odd TableStyle-Borders-Body-Row1"> <td class="TableStyle-Borders-BodyE-Regular-Row1"><p><strong>QTY per UOM</strong></p></td> <td class="TableStyle-Borders-BodyD-Regular-Row1"><p>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.</p></td> </tr> <tr class="even TableStyle-Borders-Body-Row1"> <td rowspan="4" class="TableStyle-Borders-BodyE-Regular-Row1"><p><strong>Rounding Rule</strong></p> <p> </p></td> <td class="TableStyle-Borders-BodyD-Regular-Row1"><p><strong>No Rounding</strong> -This rule allows fractional quantities of this product to be ordered. This is the default rule.</p></td> </tr> <tr class="odd TableStyle-Borders-Body-Row1"> <td class="TableStyle-Borders-BodyD-Regular-Row1"><p><strong>Round</strong> - 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).</p></td> </tr> <tr class="even TableStyle-Borders-Body-Row1"> <td class="TableStyle-Borders-BodyD-Regular-Row1"><p><strong>Round Up</strong> - This rule will round any fractional quantity up to the next integer (e.g., 1.01 = 2)</p></td> </tr> <tr class="odd TableStyle-Borders-Body-Row1"> <td class="TableStyle-Borders-BodyD-Regular-Row1"><p><strong>Multiple Only</strong> - 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)</p></td> </tr> <tr class="even TableStyle-Borders-Body-Row1"> <td class="TableStyle-Borders-BodyB-Regular-Row1"><strong>Default</strong></td> <td class="TableStyle-Borders-BodyA-Regular-Row1">If <strong>Yes</strong> is selected, this UoM will show on the website by default.</td> </tr> </tbody> </table>

## 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.