Skip to main content

How to Add Product Variants to Marketplace Offerings

Learn how product variants work and how to add products with multiple options to the Odyssey Marketplace.

A variant is a different version or option of the same product. For example, a product may be available in different sizes, colors, or other options.

If your product has variants, each option should be connected to the main product while also having its own unique SKU.

When to Use Variants

Use variants when customers need to choose between different versions of the same product.

For example, if you sell a shirt in three sizes:

  • The shirt is the main product.

  • Small, medium, and large are the variants.

  • The main product has its own SKU.

  • Each size has its own unique SKU.

If the product does not have different options, you do not need to create variants.

Adding Variants With a CSV Upload

When uploading products in bulk, products with variants require both the CSV Template and the Variant CSV Template.

Add the Main Product

In the standard CSV Template:

  1. Add the main product.

  2. Enter a unique SKU for the main product.

  3. Set is_variable to 1.

Setting is_variable to 1 identifies the product as having variants.

Add the Variants

Next, use the Variant CSV Template to add each variation of the product.

Each variant should:

  • Connect to the SKU of the main product.

  • Have its own unique SKU.

  • Include the required information for that variation.

For example:

Main product SKU: SHIRT-001

Variant SKUs:
​SHIRT-001-S
​SHIRT-001-M
​SHIRT-001-L

⚠️ Important: Each variant must have its own unique SKU. Do not use the same SKU for the main product and its variants or for multiple variants.

Products Without Variants

If a product does not have variants, enter 0 in the is_variable field.

You do not need to add that product to the Variant CSV Template.

💡 Note: Use 1 for products with variants and 0 for products without variants.

Uploading Multiple Products

For complete instructions on preparing and uploading your CSV files, see: How to Upload Multiple Offerings at Once

Fixing CSV Errors

If your CSV or Variant CSV file returns an error, review the error message and correct the file before uploading it again. How to Fix CSV Upload Errors

Need Help?

If you have questions about adding product variants, contact Odyssey Vendor Support at [email protected].

Did this answer your question?