Item Variants

Item Variants

Quick Summary: Set up interchangeable product alternatives with priority-based selection rules.

Overview

Item Variants let you define a group of interchangeable products under a single variant SKU. When an order contains a variant SKU, the system automatically selects the best available product based on priority and destination rules.

Common uses: - Regional sourcing — ship a US-made version to US customers and an EU-made version to EU customers - Supplier alternatives — prefer Supplier A's product, fall back to Supplier B when out of stock - Color/size equivalents — interchangeable product versions that fulfill the same order

Quick Start

1. Navigate to Inventory → Item Variants
2. Click the + button to create a new variant
3. Enter a SKU and Description
4. Add component products by searching for their SKU
5. Set Priority for each component (lower number = higher priority)
6. Optionally add Selection Rules for destination-based routing
7. Click Save

Item Variants List

Columns

Filters

Search

Type in the search box to filter variants by SKU or Description.

Creating an Item Variant

Required Fields

Adding Component Products

In the Items table:

1. Click + Add New SKU
2. Search for the product SKU to add as a variant option
3. Set the Priority — lower number means the system tries this product first
4. Repeat for each variant option

Selection Rules

Selection rules control which variant is used based on the order's destination. Without rules, the system uses pure priority order (highest priority with stock).

Primary Rule — the main routing logic: - Set a Destination Country - Assign a specific Variant product for that destination

Secondary Rule — fallback logic when the primary variant is unavailable.

To add a rule: 1. Under Selection Rules, click + Add New 2. Select the Destination Country 3. Select which Variant product to use for that destination 4. Optionally add a Secondary Rule as a fallback

Item Variant Detail Page

Click any variant SKU in the list to open the detail page.

Actions

Detail Sections

• Description — variant name
• Created / Last edited — timestamps
• Warehouse Stock — stock levels per warehouse (On Hand, Quarantine, Available, Reserved, Total Available)
• Items — component products with Priority, SKU, UPC, Country of Manufacture, and Description
• Selection Rules — configured destination-based routing rules

Workflows

Workflow: Set Up Regional Sourcing

When: You want to ship different product versions based on customer location

Steps: 1. Create the regional product versions as separate products in Products (e.g., WIDGET-US, WIDGET-EU) 2. Navigate to Inventory → Item Variants 3. Create a new variant (e.g., WIDGET-VARIANT) 4. Add both products and set priorities 5. Add selection rules: - Destination: United States → Variant: WIDGET-US - Destination: Germany → Variant: WIDGET-EU 6. Click Save 7. Use WIDGET-VARIANT as the SKU in orders — the system routes automatically

Result: Orders to the US use WIDGET-US; orders to Germany use WIDGET-EU.

Workflow: Set Up Supplier Fallback

When: You want to prefer one supplier but fall back to another when out of stock

Steps: 1. Create products for each supplier version 2. Create a variant and add both products 3. Set Priority 1 for the preferred supplier, Priority 2 for the backup 4. No selection rules needed — pure priority-based selection

Result: System uses the preferred supplier when in stock, automatically switches to backup when out.

Troubleshooting

Related Documentation

• Products
• Group Items
• Inventory Overview