Adding and Managing Product Variants

If your product is available in multiple variants, such as a T-shirt offered in two sizes and two colors, you can configure these variants and generate the corresponding SKUs via Variants on the product settings page.

Adding Product Variant Options and Values

If your product comes in multiple variants, you can create these variants when adding or editing the product. Follow these steps:

1. In your admin panel, go to Products and open either a product creation page or a product editing page. Locate the Variants module and check This product has multiple variants.
   
2. Click Add product variant to add variant options.
   

• Choose from preset variant options such as color, size, material, and style.

• You can also create custom variant options to meet specific needs, such as patterns or target audience.

• You can create up to five variant options.

3. Enter the corresponding variant value for each option.
   

• Press Enter after entering each value to proceed to the next one.

  Notes:  Current rule for variant values: Variant values must be unique. Entries that are identical after trimming leading and trailing spaces are treated as duplicates and cannot be saved. Handling of existing duplicate values: Previously, values with extra spaces (e.g., "red" and " red ") could be saved as separate entries. This is no longer allowed. When duplicate values from previous settings are detected, the system will prompt you to take action: If you delete a duplicated value directly in the variant value field, the corresponding variant ID will also be removed, which may impact any ads linked to that variant. To update a value without affecting its original variant ID, click the pencil icon and modify the value name in the pop-up window.

• Once all values are entered, the SKU list will automatically generate the relevant SKUs based on the set variant values.
• Each product can generate up to 500 SKUs.

Managing Variant Options and Values

If your product has been created and configured with multiple variant options and values, you can manage them on the product settings page.

Adjusting the Display Order

On the product settings page, click Variant display order to the right of Variants to adjust the order of the existing variant options and values.

• Change the order of variant options by dragging an option up or down.
• Change the order of variant values for a specific option by dragging a value left or right.
• As the order of variant options and values changes, the order of SKUs on the list page will also update.
  

Adding thumbnails for Variant Options

Click the pencil icon on the right to upload a thumbnail for each variant option. Once uploaded, the thumbnail will be displayed in the SKU selection area on the product details page.

• Supported image formats: .jpg, .png, .gif
• Recommended image size: 96px by 96px
• Maximum file size: 4 MB

Deleting Variant Options

Click the Delete button next to an existing variant option to remove it.

Editing Product Variant Information

Based on the variant options and values you configure, the corresponding product variants are automatically generated in the SKU list. For each variant, you can set the price, inventory, and other information by clicking the variant. You will then be redirected to the variant settings page.

Configuring Shipping and Package Details for a Variant

On the variant settings page, you can specify whether a variant requires shipping and record its weight, country/region of origin, HS code, and shipping package.

For SKUs that require shipping, select Shipping required, then configure the following information:

• Package: 

  • Select an existing package from the list. Each package displays its name, dimensions, and weight (for example, Package Box XL — 100 x 100 x 100 cm, 1 kg). The package information is used to calculate shipping rates and provide SKU-level data to third-party logistics providers and shipping tools.
  • Click + Add package to create one on the spot — it's applied to the variant as soon as you save it.
  • Click Manage packages to open your Shipping and delivery settings, where you can review or edit all your saved packages.

  Note: For details on creating packages, refer to "Setting Up Package Details for Accurate Shipping Rates."

• Weight: Input the product's weight and select the weight unit (grams, kilograms, pounds, or ounces). Leave blank for items like gift cards that do not require shipping (weight defaults to zero).
• Country/region of origin: The country or region a product ships from. Customs authorities use this to calculate import duties, taxes, and tariffs, and to enforce trade agreements and regulations.
• Harmonized System (HS) code: A standardized code used globally for customs and taxation purposes. HS codes are used by customs authorities worldwide to determine tariffs, duties, and other trade regulations applicable to imported and exported goods.

Bulk Editing Variant Information

Additionally, you can edit variant information in bulk by selecting multiple variants and using the following features:

• Modify the inventory
• Change the price:
  • Change the price
  • Change the compare at price
  • Change the cost price
  • Clear the compare at price
• More actions: 
  • Edit product weight
  • Set image
  • Inventory tracking
  • Shipping info:
    • Edit package 
    • Remove package 
    • Edit product weight
    • Edit HS code
    • Edit country/region of origin
  • Tax
  • Continue selling when out of stock
  • Modify SKU
  • Modify HS Code
  • Modify shipping country
• Batch editor: You can also click Batch editor to edit your variants in batches.
• Delete: Click to bulk delete all selected variants.