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
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
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
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
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
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.
Tick any that happen here.
In ERPNext, and in your system
How ERPNext models it
| DocType | What it does here |
|---|---|
| UOM | The 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 Detail | The 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 Factor | A 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 Detail | transfer_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 Settings | Float 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
| System | Name | Note |
|---|---|---|
| ERPNext | UOM Conversion Detail (on the Item) and UOM Conversion Factor | The Item's UOM table holds the ratios; the global UOM Conversion Factor table holds standard ones. |
| Tally | Units 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 Books | Unit 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 One | Unit of Measure Groups | Administration > 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. |
| Odoo | Units 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
More terms it connects to
Each one opens that term.
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?
- Catch-weight goods, where a bag is nominally 50 kg and really 49.5 kg. A fixed factor is wrong by definition. Tally's alternate unit takes the conversion per transaction. A fixed-factor system has to hold stock in the weight unit.
- A rate quoted per box and a valuation held per piece, which are the same money in two units. The rate has to be divided by the factor, and the rounding of that division is where valuation drifts.
- The same unit with different ratios for different items: a carton holds 24 of one item and 12 of another. The ratio belongs to the item, not to the unit.
- Selling by a unit smaller than the stock unit, such as cable by the metre from a reel. That unit has to allow fractions, and the stock unit's precision has to be fine enough to hold the result.
Reviewed 14 October 2026. All 40 documents: the ERP glossary.