# Item Unit Conversion

<p class="doc-lead">Item Unit Conversion sets the conversion factor between two units for a specific item, so the same item can be bought, stocked, and sold in different units. Use it when an item's units do not share the standard base-unit relationship.</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/unit-conversion?id=overview">Overview</a>
<a href="#/inventory/unit-conversion?id=quick-start">Quick Start</a>
<a href="#/inventory/unit-conversion?id=fields">Fields</a>
<a href="#/inventory/unit-conversion?id=how-it-works">How It Works</a>
<a href="#/inventory/unit-conversion?id=actions">Actions</a>
<a href="#/inventory/unit-conversion?id=faq">FAQ</a>
<a href="#/inventory/unit-conversion?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 Conversions</b> from the left menu.

Item Unit Conversions are master data. Each row reads as: 1 of the <b>From Unit</b> equals the <b>Quantity of To Unit</b> value in the <b>To Unit</b> — for a particular item.

<b>List columns</b>

| **Column** | **Description** |
|------------|-----------------|
| Id | Conversion record ID. |
| Item | Item this conversion applies to. |
| From Unit | Source unit. |
| Multiplier | Conversion factor. |
| To Unit | Target unit. |
| Status | Active or Suspended. |

<b>Quick filter tabs</b>

| **Tab** | **Shows** |
|---------|-----------|
| Active | Active conversions (default). |
| Suspended | Suspended conversions. |

<b>Advanced filters</b>

| **Filter** | **Description** |
|------------|-----------------|
| Item | Filter by item. |
| From unit | Filter by source unit. |
| To Unit | Filter by target unit. |
| Status | Active or Suspended. |
| Created Date | Date the conversion was created. |

<b>List row actions</b>

| **Action** | **Description** |
|------------|-----------------|
| View | Opens read-only conversion details. |

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

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

<h3>1. Navigate</h3>
Go to <b>Inventory → Settings → Item Unit Conversions</b> and click <b>New</b>.

<h3>2. Fill the form</h3>
Choose the <b>Item</b>, the <b>From Unit ( 1 Qty )</b>, the <b>Quantity of To Unit</b>, and the <b>To Unit</b>.

<h3>3. Save</h3>
Click <b>Save</b>. The conversion is applied when the item is transacted between these units.

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

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

| **Field** | **Description** |
|-----------|-----------------|
| Item * | The item this conversion applies to. |
| From Unit ( 1 Qty ) * | The starting unit. The factor is expressed per 1 of this unit. Only base units can be selected. |
| Quantity of To Unit * | How many of the <b>To Unit</b> equal one <b>From Unit</b> (the multiplier). |
| To Unit * | The target unit the quantity converts to. Only base units can be selected. |

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

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

<ul>
<li><b>Per-item conversion</b> — Unlike the base-unit multiplier on <a href="#/inventory/inventory-units">Units</a> (which applies to all items), this conversion is specific to one item.</li>
<li><b>How it reads</b> — 1 <b>From Unit</b> = <b>Quantity of To Unit</b> × <b>To Unit</b>. The system uses this factor (in either direction) when an item moves between the two units on transactions.</li>
<li><b>When to use</b> — Use it for items where unit relationships are not standard, such as weight-to-piece conversions that vary by item.</li>
<li><b>Reporting unit</b> — Reports for an item are based on the unit assigned when the item was created; conversions let entry happen in other units.</li>
</ul>

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

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

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

| **Action** | **Description** |
|------------|-----------------|
| View | Opens the conversion in read-only view |
| Suspend / Activate | Disables or re-enables the conversion (from the view screen) |

<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>How is this different from the base unit and multiplier on a Unit?</b><br>
A unit's base/multiplier defines a standard relationship for every item using those units. Item Unit Conversion defines a factor for one specific item, which is useful when the relationship varies by item.

<b>Which units can I pick?</b><br>
Both <b>From Unit</b> and <b>To Unit</b> must be base units.

<b>Does the conversion work both ways?</b><br>
Yes. The factor is applied in either direction when the item is transacted between the two units.

<b>When should I use item conversion instead of unit multiplier?</b><br>
Use unit base/multiplier for standard relationships shared by all items. Use item conversion when one product packs differently (e.g. case vs piece ratio unique to that SKU).

<b>Do conversions affect stock reports?</b><br>
Reports can show quantities in report unit using conversion factors when <b>Show Report Unit</b> is enabled on stock reports.

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

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