# Item Unit Update

<p class="doc-lead">Item Unit Update changes an item's inventory-keeping unit after stock movements exist. It rewrites historical quantities and unit costs so quantity × value stays the same. Use this instead of editing the unit on the item master.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<div class="doc-toc-links">
<a href="#/inventory/item-unit-update?id=overview">Overview</a>
<a href="#/inventory/item-unit-update?id=quick-start">Quick Start</a>
<a href="#/inventory/item-unit-update?id=fields">Fields</a>
<a href="#/inventory/item-unit-update?id=how-it-works">How It Works</a>
<a href="#/inventory/item-unit-update?id=actions">Actions</a>
<a href="#/inventory/item-unit-update?id=faq">FAQ</a>
<a href="#/inventory/item-unit-update?id=related">Related</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview &amp; List View</h2>

Go to <b>Inventory → Settings → Item Unit Updates</b> from the left menu, or open an item and choose <b>Update item unit</b> from More.

Save a draft first. Approve applies the unit change and quantity rewrite. The item master unit field still cannot be changed directly once inventory ledgers exist.

<b>List columns</b>

| **Column** | **Description** |
|------------|-----------------|
| Id | Request ID. |
| Item | Item whose inventory unit will change. |
| Previous Unit | Inventory-keeping unit before approve. |
| New Unit | Inventory-keeping unit after approve. |
| Multiplier | Factor applied to net quantities. |
| Reason | Why the unit is being changed. |
| Ledgers Updated | Inventory ledger rows rewritten on approve. |
| Status | Draft or Approved. |

<b>Advanced filters</b>

| **Filter** | **Description** |
|------------|-----------------|
| Item | Filter by item. |
| Previous Unit | Filter by old unit. |
| New Unit | Filter by new unit. |
| Status | Draft or Approved. |
| Created Date | Date the request was created. |

<b>List row actions</b>

| **Action** | **Description** |
|------------|-----------------|
| View | Opens the request. |
| Edit | Edit a draft request. |
| Delete | Delete a draft request. |

<hr class="doc-section-divider">

<h2 id="quick-start">Quick Start</h2>

<h3>1. Navigate</h3>
Go to <b>Inventory → Settings → Item Unit Updates</b> and click <b>New</b>, or from an item view choose <b>More → Update item unit</b>.

<h3>2. Fill the form</h3>
Select the <b>Item</b>. <b>Previous Unit</b> is filled from the item. Choose the <b>New Unit</b>, enter the <b>Multiplier</b>, and a <b>Reason</b>.

Example: old unit = Kilogram, new unit = Gram, multiplier is 1000 (so a netQuantity of 1 becomes 1000). Unit cost is divided by the same multiplier so quantity × value stays the same.

<h3>3. Save, then Approve</h3>
Click <b>Save</b> to create a draft. Open the request and click <b>Approve</b>. Approve rewrites stock history and sets the item's inventory unit. This cannot be cancelled after approve.

<hr class="doc-section-divider">

<h2 id="fields">Fields</h2>

| **Field** | **Description** |
|-----------|-----------------|
| Item * | Item whose inventory-keeping unit will change. |
| Previous Unit | Current inventory-keeping unit. Filled from the item and cannot be edited. |
| New Unit * | Unit to switch to. Must be different from the previous unit. |
| Multiplier * | Converts quantities from the old unit to the new unit. Must be greater than 0. Use 1 to change the unit without rewriting quantities or unit costs. |
| Reason * | Why the unit is being changed. |
| Inventory Ledgers Updated | Number of ledger rows rewritten (set on approve). |
| Inventory Rows Updated | Number of current stock rows rewritten (set on approve). |
| Item Lines Updated | Number of transaction lines whose netQuantity was rewritten (set on approve). |
| Approved Date | When the request was approved. |

<hr class="doc-section-divider">

<h2 id="how-it-works">How It Works</h2>

<ul>
<li><b>Draft then approve</b> — Saving does not change stock. Approve rewrites data in one transaction.</li>
<li><b>Quantities</b> — Inventory ledger in/out quantity, current stock quantity, and transaction <b>netQuantity</b> are multiplied by the multiplier. Entered line quantity and line unit are not changed.</li>
<li><b>Unit cost</b> — Ledger and inventory unit cost are divided by the multiplier so quantity × value is unchanged. Accounts and journals are not updated.</li>
<li><b>Revaluation rows</b> — Ledger rows with zero in and out quantity keep their value (that amount is a total, not a unit cost).</li>
<li><b>Serial-numbered items</b> — Not allowed. Serial quantity is one per piece and would not match a scaled quantity.</li>
</ul>

What is not changed: item sale/purchase/report units, item prices and reorder quantities, item unit conversions, BOM quantities, and accounting journals.

<hr class="doc-section-divider">

<h2 id="actions">Actions</h2>

<b>List header:</b> <b>New</b>

| **Action** | **Description** |
|------------|-----------------|
| Approve | Applies the unit change. Shown only on draft. Cannot be undone. |
| Edit | Edit a draft request. |
| Delete | Delete a draft request. |
| Clone | Create a new request from this one. |
| Print | Print the request. |

<b>Form buttons:</b> <b>Save</b> / <b>Update</b>, <b>Reset</b>, <b>Cancel</b>

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>Why can't I change the unit on the item master?</b><br>
Once inventory ledgers exist, the item unit field is blocked so stock is not left in mixed units. Use <b>Item Unit Update</b> instead.

<b>What is the multiplier?</b><br>
It is how many new units equal one old unit. Kilogram to gram is 1000. Gram to kilogram is 0.001. Use 1 when the quantity meaning does not change and only the item unit should be updated.

<b>Does this change sale prices?</b><br>
No. Sale price, cost price, MRP, and reorder quantities stay as they are. Update those on the item if the new unit needs different prices.

<b>Can I reverse an approved update?</b><br>
No. Create another Item Unit Update with the inverse multiplier if you need to switch back.

<b>Can I run this on a serialized item?</b><br>
No. Serial-tracked items are rejected because serial counts would no longer match quantity.

<h2 id="related">Related Topics</h2>

<ul>
<li><a href="#/inventory/inventory-item">Item</a></li>
<li><a href="#/inventory/inventory-units">Units</a></li>
<li><a href="#/inventory/unit-conversion">Item Unit Conversion</a></li>
<li><a href="#/inventory/inventory-settings">Inventory Settings</a></li>
</ul>
