Skip to main content

How Unit Class Conversions Work in Luminous (and Why They Matter for Your BOMs)

Heidi Hatch avatar
Written by Heidi Hatch
Updated over 3 months ago

When setting up Bills of Materials (BOMs) or tracking inventory in Luminous, itโ€™s critical to understand how units of measure and unit classes work โ€” especially when you're working with both bulk and small measurement units like gallons and ounces.

๐Ÿ” Can I Convert Between Ounces and Gallons?

Yes โ€” but only if they belong to the same unit class.

Luminous supports unit conversions within the same class (like fluid volume or weight), but does not support cross-class conversions (like volume โ†” weight).


โš™๏ธ How Unit Classes Work

A Unit Class defines the type of measurement โ€” for example:

  • Quantity (each, dozen)

  • Weight (grams, pounds, kilograms)

  • Volume (ounces, gallons, liters)

  • Length (inches, feet, yards)

Each SKU is assigned a unit class, and only units within that class can be converted.

So:
โœ… Ounces to Gallons (volume to volume) = Allowed
โŒ Ounces to Pounds (volume to weight) = Not Allowed


๐Ÿ”ง Setting Up Conversion Rules (Within the Same Class)

To enable internal conversions, like from ounces to gallons:

  1. Go to Inventory Admin > Units of Measure

  2. Under the Conversion Rules tab:

    • Select your base unit (e.g., ounces)

    • Choose your target unit (e.g., gallons)

    • Set the conversion factor (e.g., 128 oz = 1 gallon)

These rules can be:

  • System-wide (applied across all products)

  • SKU-specific (helpful if different products have different densities or use-cases)


๐Ÿงช Example Use Case โ€“ Bike Lubricant

Sam asked:

โ€œThe bike lubricant is in 4 oz, can I put 4 and then oz or should I have everything in gallons?โ€

Hereโ€™s how we recommend approaching it:

If you purchase or receive it in 4 oz bottles but track and plan BOMs in gallons, set up a conversion rule:

  • Base Unit: Ounce

  • Target Unit: Gallon

  • Conversion: 128 oz = 1 gal

Now, in your BOM:

  • You can input 4 oz for the component

  • Luminous will convert that into gallons during assembly or purchasing

  • This allows for cleaner tracking without forcing everything into a single unit

This keeps your numbers readable (no more 0.03125 gal per unit) and your data clean.


๐Ÿ’ก Best Practices

  • Pick the right base unit: Go with the smallest common unit to avoid decimal complexity.

  • Use conversion rules where it makes sense: For example, convert grams to pounds for raw ingredients, or ounces to gallons for liquids.

  • Avoid mixing classes: If something is measured by weight (lbs), donโ€™t try to convert it into a volume (gallons). If needed, you'll need to handle that outside of Luminous (e.g., via a density-based calculator or production SOP).


๐Ÿ’ฌ Final Thoughts for BOM Setup

When building BOMs:

  • Stay within one unit class per raw material

  • Use conversions to switch between purchasing/selling units (e.g., buy in bulk, use in small quantities)

  • Keep units readable to make ongoing BOM updates easier for the team

Did this answer your question?