Skip to main content

Stock · step 2 of 6

UOM Conversion

A UOM (unit of measure) conversion is the fixed ratio that restates a quantity counted in one unit as a quantity in another, so that stock can be held in a single unit while buying, selling and manufacturing happen in others.

Why it exists: Because the unit a supplier sells in, the unit the warehouse counts in and the unit a customer buys in are rarely the same, and stock can only be added up in one.

Where it sits

  1. Item

    set on

  2. UOM ConversionThis document

  3. Batch

    applied on

Stock: Item → UOM Conversion → Batch → Serial Number → Warehouse → Stock Entry

How a UOM conversion moves through its life

Four states. Pick one to see what a UOM conversion is, and what it can still become.

The item has a stock unit with factor one and a row for each other unit with its ratio. ERPNext fills a blank ratio from its table of standard conversions.

Then: In use

UOM Conversion1 of 4
UOM ConversionDefined

The item has a stock unit with factor one and a row for each other unit with its ratio. ERPNext fills a blank ratio from its table of standard conversions.

Then: In use

Every transaction row carries the factor it was created with. Quantities convert to the stock unit as quantity times factor, and stock is posted in that unit.

Then: Fixed

UOM Conversion2 of 4
UOM ConversionIn use

Every transaction row carries the factor it was created with. Quantities convert to the stock unit as quantity times factor, and stock is posted in that unit.

Then: Fixed

Once the item has stock ledger entries, its stock unit cannot be changed directly. A different base unit means a new item.

Then: Revised

UOM Conversion3 of 4
UOM ConversionFixed

Once the item has stock ledger entries, its stock unit cannot be changed directly. A different base unit means a new item.

Then: Revised

A corrected ratio applies to new documents. Submitted documents keep the factor stored on their own rows, so earlier stock and value stay as posted until they are repaired.

Ends here

UOM Conversion4 of 4
UOM ConversionRevised

A corrected ratio applies to new documents. Submitted documents keep the factor stored on their own rows, so earlier stock and value stay as posted until they are repaired.

Ends here

Rules that must hold, and what breaks them

Rules

  • Every item has one stock unit, and the factor from that unit to itself is one. Every other unit is a fixed multiple of it, and stock is held and valued only in the stock unit.
  • A conversion only makes sense between units of the same kind. Metres convert to centimetres and boxes to pieces. Kilograms to pieces needs a weight per item, not a global factor.
  • A document keeps the factor it was saved with. Changing the ratio on the item affects new documents only, so a wrong ratio is corrected going forward and the stock it already moved is repaired separately.

Does this happen in your business?

Tick what you recognise. Each tick shows what it costs.

Mistakes people make with UOM conversions

Tick any that happen here.

In ERPNext, and in your system

How ERPNext models it

DocTypeWhat it does here
UOMThe unit itself: name, enabled and must_be_whole_number. A unit left open to fractions accepts quantities such as 2.5, so pieces and cartons need the flag.
UOM Conversion DetailThe child table on Item: one row per unit with its conversion_factor to the stock unit, to nine decimal places. The stock unit's own row must be one, and a unit cannot appear twice.
UOM Conversion FactorA global table of ratios between units of the same category, such as kilogram to pound. An item row uses it when its own factor is blank.
Stock Entry Detailtransfer_qty is qty times conversion_factor, rounded to the field's precision, and stock is posted in that quantity. Purchase and sales rows carry the same pair as stock_qty.
System SettingsFloat Precision decides how many decimals a converted quantity keeps, and Currency Precision does the same for rates and amounts. Changing either should not be assumed to correct documents already submitted.

What other systems call it

SystemNameNote
ERPNextUOM Conversion Detail (on the Item) and UOM Conversion FactorThe Item's UOM table holds the ratios; the global UOM Conversion Factor table holds standard ones.
TallyUnits of Measure (Simple, Compound and Alternate units)A compound unit has a fixed conversion. An alternate unit takes its conversion per transaction. A unit takes at most four decimal places.
Zoho BooksUnit Conversion (Unit Groups)Zoho Inventory. Switch on unit conversion first, then group a base unit with target units. The same units can carry different ratios in different groups.
SAP Business OneUnit of Measure GroupsAdministration > Setup > Inventory. A group has a base unit, and every other unit is tied to it by a conversion rule. Units are defined first, in Units of Measure - Setup.
OdooUnits of Measure (UoM Categories)Needs the Units of Measure setting. Units convert only inside one category, against its reference unit, by a Ratio.

From each maker's own documentation, checked 13 October 2026. A dash: not confirmed.

Where a UOM conversion connects

Questions about UOM conversions

The one most people ask is answered first. Type to find the rest.

What does a UOM conversion mean for the business?

UOM conversion looks like housekeeping and decides whether stock and cost are right. Every purchase in cartons and sale in pieces passes through the factor twice. One wrong factor misstates quantity on hand, valuation, reorder points and margin together, on every transaction the item ever touches, and it is rarely noticed until the count.

Reviewed 14 October 2026. All 40 documents: the ERP glossary.

Start with one conversation

One message, call or WhatsApp is enough. Every line reaches the team directly.

Team away now