Product Variants

StoreConnect uses a master product and variant products model, where a master product will be the one that shows up in search, and the variant products are the ones that are added to a cart.

First a couple of definitions:

So, if you have 2 types of variant (perhaps size and colour) and 3 options in each type (small, medium, large and red, green, blue) then this would require a total of 10 products to allow you to select any one of them.

Of course, if you do not have a Large Green product available (either no variant product or the variant product is unavailable because it is out of stock), then that option will not be available to select.

To add a variant, navigate to the master product and click on the related tab. You should see both “Variant Products” and “Master Products” on the related page.

The Variant Products list is the list of products that belong to the current Master Product we are viewing.

The Master Products list shows all the master products variant types that this Variant Product belongs to.

If we are looking at our “Cool T-Shirt” master product above, and we have already created the 9 variant products for each size/colour combination, the process of adding them would be:

  1. Go to the Cool T-Shirt master product
  2. Click on the related tab
  3. Click new next to “Variant Products”
  4. The “Cool T-Shirt” will already be listed as the Master Product
  5. Search for Cool T-Shirt Small Red in the Variant Product field and select it
  6. Select “Size” from Variant Type
  7. Type “Small” in the Variant Value
  8. Select a position (increments of 10 are a good choice to allow easy insertion of new sizes later)
  9. Click “Save and New”
  10. You will have the form again with “Cool T-Shirt” already listed as the Master Product
  11. Search for Cool T-Shirt Small Red in the Variant Product field and select it
  12. Select “Color” from Variant Type
  13. Type “Red” in the Variant Value
  14. Select a position (increments of 10 are a good choice to allow easy insertion of new sizes later)
  15. Click “Save”

This will successfully add the variant for both size Small and colour Red to the Cool T-Shirt Master Product.

Repeat the above steps for the other 8 products, or create this in a spreadsheet and use a tool like to do a bulk upload.

Display and Positioning

If you have a Variant Type with five or fewer values, each value will display as a button on the product page. If you have more than five values, they will show in a drop-down menu.

Variant Types and Variant Values are positioned on your product page by the values in the position field. Lower numbers appear first. When configuring the Variant Types for Colour, “Cool T-Shirt Red (S)” set at position 10 would appear before “Cool T-Shirt Blue (S)” set at position 20.

To make the sizes display below the colour options, you would use larger numbers for the size positions than were used for the colours. eg. Small position = 100, Medium position = 110 etc.


Master and Variant Product Pricing

When configuring prices for your variant products, make sure:

Product Variants that belong to the same Master Product can have different prices configured for them.

You can configure the Master Product to display the least amount your customers can expect to pay for the related Product Variants. To do this, navigate to the Master Product Price Book entry and select “Hide Price”. Fill in the “Hide Price Text” with something like “Starting from $9.99”

Bulk Uploading Variants

Variant Product relationships are stored in the Product_Variant__c object.

Field Mapping:

Back to Documentation