Item Variants

An Item Variant is a version of an Item with different attributes like sizes or colors.

Eg: A blue t-shirt in size small rather then just a t-shirt. Item variants let you treat the small, _medium and large versions of a t-shirt as variations of one Item 't-shirt'.

Without Item variants, you would have to treat the small, medium and large versions of a t-shirt as three separate Items.

1. Using Item Variants

Variants can be based on two things:

  1. Item Attributes
  2. Manufacturers

Tip: Once an item template is created, when you update this template, all the variants are also updated accordingly.

1.1 Item Variants Based on Item Attributes

  1. To use Item Variants in ERPNext, create an Item and tick 'Has Variants' under Variants.

  2. The Item then shall be referred to as a so called 'Template'. Such a Template is not identical to a regular 'Item' any longer. For example it (the Template) cannot be used directly in any transaction (Sales Order, Delivery Note, Purchase Invoice) itself.

  3. Only the Variants of the Item (blue t-shirt in size small) can be practically used. Therefore it would be ideal to decide whether an item 'Has Variants' or not directly when creating it.

    Has Variants

  4. On selecting 'Has Variants' a table will appear. Specify the variant attributes for the Item in the table. In case the attribute has Numeric Values, you can specify the range and create intervals based on the increment values.

    Valid Attributes

    Note: You cannot make Transactions against a 'Template'.

  5. To create 'Item Variants' against a 'Template' click on 'Create'. From there, choose whether to create a single variant or multiple. Single is simple where you just one or more attributes and one item will be created. When choosing multiple variants, tick the atrributes and multiple items will be created. For example, if you choose Color: Red, Green and Size: Small, Medium, Large, 6 variants will be created.

    Creating multiple variants in ERPNext:

    Make Variants

To learn more about setting attributes check out Item Attributes

1.2 Item Variants Based on Manufacturers

To setup variants based on Manufacturers, in your Item template, set "Variants Based On" as "Manufacturers" In this case, to create variants, click on Create > Make Variant. The system will prompt you to select a Manufacturer. You can also optionally put in a Manufacturer Part Number.

Setup Item Variant by Manufacturer

The naming of the variant will be the name (ID) of the template Item with a number suffix. e.g. "Screw driver" will have variant "Screw driver-1".

2. Update Item Variants Based on Template

Go to: Stock > Items and Pricing > Item Variant Settings. The fields displayed here will be copied over to the variants as well. Delete any rows you don't want to be updated from the item template to the variants.

  1. Item Group
  2. Item Attribute
  3. Item Price
  4. Item Codification