Units of Measure

Units of measure (UOM) let you attach standardized unit systems to your numeric product attributes. Instead of storing a raw number in a weight or dimension field, you define a UOM code set (a named group of related units) and link it to an attribute. Your catalog then carries consistent, convertible measurements that export correctly to every channel.

​

UOM code sets

Go to Products → Attribute Options → Units of Measurement to see and manage your code sets. Each code set has:

• Name and Code: the display name and a unique slug (lowercase, no spaces).
• Category: one of Weight, Length, Volume, Area, Quantity, Time, or Custom. Pick Custom for anything that does not fit the standard types, such as pallets, rolls, or boxes.
• Base unit: the reference unit with factor 1. All other units in the set specify how many base units they equal (e.g., if cm is the base: mm = 0.1, m = 100).

​

Creating a code set

Click New Unit Set. Fill in the name, code, optional description, and category. Then add units one by one under Unit Values: Mark one unit as Base unit (it gets factor 1 automatically). Click Set as base on any row to promote it. You can also set validation rules per unit: minimum value, maximum value, and decimal precision. Click Save Changes (or Create Code Set for a new one). The code set is immediately available for linking to attributes.

​

Editing a code set

Click the edit icon on any row in the table. You can rename the set, add or remove units, change the base unit, and update conversion factors. Changes apply to all products using that code set.

​

Display format and export settings

Each code set has two additional configuration sections in its modal: Display format controls how values appear in the app: decimal separator (period or comma), thousands separator, and number of decimal places. Export settings control how values land in exports:

• Append: value and unit in one column, e.g. 100 mm
• Separate columns: value and unit in separate columns (configure column name suffixes)
• Ignore unit: value only, no unit exported

You can override the export setting per export run from the export dialog.

​

Importing UOM via the UOM Importer

For large catalogs, use the UOM Importer to load unit sets from a CSV file. Access it from the Import CSV button on the Units of Measurement page. The importer walks you through four steps:

​

Applying UOM to products

Link a UOM code set to a product attribute in Other Features → Managing Attributes. Set the attribute type to Number or Decimal (the UOM field only appears for these types) and choose the code set from the UOM field. After linking, every product that uses that attribute will display values with their unit and benefit from conversion and export features. When editing a single product, a UOM field shows a unit selector alongside the numeric input. Pick the unit that applies to that product.

​

Changing UOM in bulk

To change the unit of measure across many products at once, use the bulk edit action Change Unit of Measure. Select products, open Bulk Edit, and find it under Attributes and Custom Fields. You can convert both the unit label and the actual numeric values using the conversion factor from the code set. See Change Unit of Measure for full details.

​

Related