> ## Documentation Index
> Fetch the complete documentation index at: https://help.owlery.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Item Variants

> Send a warehouse a different SKU than the one in your Item Master and ERP.

This page is for **Shippers**: teams that quote, tender, and pay for freight in Owlery. If the person you're helping isn't a shipper, this page doesn't apply to them.

**Where to find it:** `Dashboard → Item Master → (open a SKU) → Variants`

A variant lets a warehouse receive a different SKU than the one you use. Your SKU stays the same in Owlery and your ERP. Orders, ASNs, and BOLs sent to that warehouse show the variant SKU instead.

Use a variant when a warehouse:

* Tracks an item under a different SKU than you do.
* Shouldn't receive part of your SKU, such as extra text your ERP adds.
* Counts an item in a different unit or pack size than you do.

## How Variants Work

Each variant connects your SKU to a variant SKU for one warehouse company. The variant SKU is also an item in your Item Master.

* **Orders, ASNs, and BOLs sent to that warehouse**: show the variant SKU. If you set a **Preferred Unit**, quantities convert too.
* **Updates from that warehouse**: show under your SKU in Owlery.
* **Every other warehouse**: keeps receiving your SKU, until you add a variant for it.
* **Your ERP and reports**: keep your SKU.

A variant applies to every location the warehouse company runs in Owlery. It applies to orders you send after you save it.

## Add Variants

> [tab] One SKU
>
> The variant SKU must already be in your Item Master. If it isn't, add it with **+ Add Item** first, or use a CSV upload, which creates it for you.
>
> **1. Open your SKU**
>
> In `Dashboard → Item Master`, open the SKU you want to map, then open the **Variants** tab.
>
> **2. Add the variant**
>
> Click **+ Variant**. In **Select a variant SKU**, pick the SKU the warehouse should receive.
>
> **3. Choose the warehouse**
>
> Turn on **Add facility-specific conversion**. In **Facility**, pick each warehouse company that should receive the variant SKU.
>
> **4. Set the unit, if needed**
>
> If the warehouse counts this item in a different unit, pick it in **Preferred Unit**. Otherwise leave it blank. See [Units and Quantities](#units-and-quantities).
>
> **5. Save**
>
> Click **Confirm**. The variant shows in the **Variants** tab and in the **Variant SKU** column of the Item Master.
>
> To change or remove a variant, use **Edit** or **Delete** on its row in the **Variants** tab.

> [tab] Many SKUs (CSV)
>
> A CSV upload creates any variant SKU that isn't in your Item Master yet. Your own SKUs must already exist.
>
> **1. Download the template**
>
> In `Dashboard → Item Master`, open the menu next to **Upload** and click **Download Variant Template**. It lists the variants you already have.
>
> **2. Fill in one row per SKU and warehouse**
>
> Fill in the columns in the table below. To send the same variant SKU to two warehouses, add two rows.
>
> **3. Upload the file**
>
> Open the menu next to **Upload**, click **Upload Variant**, and pick your file.
>
> **4. Choose how to import**
>
> * **Add to existing variants**: keeps your current variants and adds the new rows. Rows that conflict with a current variant are rejected.
> * **Replace existing variants**: replaces all current variants for each SKU in the file.
>
> **5. Fix flagged rows and confirm**
>
> Owlery checks every row before saving and lists any that need fixing. Once they're fixed, confirm the upload. The variants show in the **Variant SKU** column of the Item Master.
>
> | Column | What to enter |
> | - | - |
> | **Sku** | Your SKU, exactly as it appears in the Item Master. |
> | **Variant Sku** | The SKU the warehouse should receive. |
> | **Facility Email Domain** | The warehouse company's email domain, such as `warehouse.com`. |
> | **Facility Email Domain Variant Unit Of Measure** | Optional. The unit the warehouse counts in. |
> | **Facility Email Domain Original Sku Quantity** and **Facility Email Domain Variant Sku Quantity** | Optional. A same-unit ratio. See [Units and Quantities](#units-and-quantities). |

## Units and Quantities

Most variants only change the SKU. Leave the unit settings blank and quantities stay the same.

* **Preferred Unit**: set it when the warehouse counts in a different unit, such as Each instead of Case. Owlery converts the quantity using your SKU's [packaging hierarchy](https://help.owlery.ai/shippers/item-master.md#packaging-hierarchy), so make sure it's complete.
* **Same unit, different size**: this is uncommon. Use it when you and the warehouse both call the unit the same thing, but it holds a different amount. For example, both say Case, but your case holds 24 and theirs holds 12. Turn on the ratio switch under **Preferred Unit** and enter how many of your units equal how many of theirs. Both numbers must be whole numbers above zero.

## Rules

* **One variant per warehouse**: a SKU can have a different variant for each warehouse company, but only one for each.
* **One SKU per variant**: a variant SKU belongs to one of your SKUs. Two of your SKUs can't share a variant SKU.
* **One role per SKU**: a SKU is either your SKU or a variant SKU, never both.
* **One row per SKU**: Owlery doesn't change SKUs by pattern, such as removing text from every SKU. Add a variant for each SKU. Use a CSV to add many at once.
* **Retailer ASNs**: EDI ASNs sent to retailers keep your SKU. Variants apply to what Owlery sends warehouses.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.