Item Variants
Item Variants allow you to manage different versions of the same product based on attributes such as size, color, or manufacturer without creating completely separate items manually.
An Item Variant is a variation of a common product that differs by one or more attributes. Instead of creating separate Items for every combination, ERPNext lets you create a single Item Template and generate multiple variants from it.
For example, consider a T-Shirt that comes in multiple colors and sizes.
Example
- Item Template: T-Shirt
- Red – Small
- Red – Medium
- Blue – Small
- Blue – Medium
- Green – Large
Instead of creating each of these as unrelated Items, ERPNext treats them as variants of the same product.
1. Item Template vs Item Variant
Before creating variants, you must first create an Item Template.
- Item Template – Defines the common product and its attributes.
- Item Variant – Represents a specific combination of those attributes.
An Item Template cannot be used directly in purchase, sales, manufacturing, or stock transactions. Only the generated Item Variants can be selected in transactions.
2. Creating an Item Template
To create an Item Template:
- Create a new Item.
- Enable the Has Variants checkbox.
- Select the attributes that define the variants.
- Save the Item.
Once saved, the Item becomes an Item Template instead of a regular inventory item.
3. Creating Variants Using Item Attributes
Item Variants are commonly generated using Item Attributes such as:
- Color
- Size
- Material
- Length
- Capacity
After creating the template, click Create → Make Variant. ERPNext allows you to generate either:
- Single Variant – Create one combination at a time.
- Multiple Variants – Generate every possible combination automatically.
If the template has:
- Colors: Red, Blue
- Sizes: Small, Medium, Large
ERPNext automatically creates six variants:
- Red – Small
- Red – Medium
- Red – Large
- Blue – Small
- Blue – Medium
- Blue – Large
4. Variants Based on Manufacturer
ERPNext also supports creating variants based on different manufacturers instead of product attributes.
To use this feature:
- Open the Item Template.
- Set Variants Based On to Manufacturer.
- Click Create → Make Variant.
- Select the Manufacturer and optionally enter the Manufacturer Part Number.
ERPNext automatically generates a separate Item Variant for each manufacturer.
5. Updating Variants from the Template
One of the biggest advantages of Item Variants is centralized management.
Whenever common information is updated in the Item Template, ERPNext can automatically update all related variants.
The fields that are synchronized can be controlled from:
Stock → Items and Pricing → Item Variant Settings
Only the fields configured in Item Variant Settings are copied from the template to the variants. Unwanted fields can be removed from this list.
6. Benefits of Item Variants
- Avoids creating duplicate Items manually.
- Keeps similar products organized under a single template.
- Supports multiple attribute combinations automatically.
- Allows centralized updates from the Item Template.
- Simplifies inventory, purchasing, and sales management.
- Improves reporting for products with multiple variations.
Summary
Item Variants in ERPNext enable businesses to manage multiple versions of the same product efficiently. By using an Item Template with attributes or manufacturers, organizations can automatically generate product variations, maintain consistent information across all variants, and simplify inventory management without creating duplicate Item records.
