Skip to main content

Variant

The Variant is the specific declination of the product. It represents a commercial specialization based on distinctive characteristics (such as color or material). If the Product is the general template, the Variant is the element that defines the different models ready for display.

Inheritance and Overwriting​

Variant management in Webround Commerce is based on a powerful inheritance system. Since a variant often shares many properties with the parent product, you can choose how to manage data and relationships through two modes:

  1. Inheritance (Active Flag): The variant automatically "copies" the product settings. If you add an element (e.g., a shipping zone) at the variant level while maintaining inheritance, it will be added to those already defined on the product.
  2. Overwriting (Disabled Flag): By removing the inheritance flag, the variant breaks the link with the product for that specific field. This allows you to entirely redefine the data (e.g., setting completely different package dimensions or replacing shipping methods).

Integrity Rule: It is not possible to manually relink elements that the variant is already inheriting from the product. If you wish to define a specific subset of links (e.g., limiting the variant to only one of the three couriers available on the product), you must disable inheritance for that field and proceed with manual configuration.

Fields subject to inheritance:

  • Assets (Images and Videos)
  • Tags and Attributes
  • Package Dimensions and Weight
  • Logistics (Shipping Methods, Shipping Zones, and Tax Zones)
  • Coupon Settings

Identity and Navigation​

Each variant possesses unique attributes for its identification on the frontend:

  • Name: The specific name of the declination (e.g., "Nike Pegasus 41 - Total White").
  • Slug: Fundamental for navigation. The slug is the "friendly-url" part that uniquely identifies that variant within the site.
  • URL Structure: yourdomain.com/product/[slug]
  • Default Variant: A flag that determines which variant should be loaded first when the user lands on the general product page.

Relationship with SKUs and Options​

As mentioned in the introduction, Options (e.g., "Size") are defined at the Product level, but it is at the Variant level that these come to life to generate SKUs.

  • SKU Generation: SKUs are direct children of the variant. When you use the auto-generation function, the system crosses the current variant with the options defined on the product.
  • Tag Assignment: Since options are technically groups of Tags, during SKU generation, the variant automatically receives all the tags that constitute those options. This ensures that the variant is correctly filterable and categorized based on all the purchase choices it contains.
Filterability

If, for example, you create a "Shoe Size" option and enter values such as the possible measurements for that shoe size and associate them with the variant, after the automatic generation of SKUs, the variant will already be correctly tagged with all sizes. By setting the Tag as filterable, you can use the values of that tag to filter the variant in your store.

If a shoe variant has the option Size: 44, that Tag Value will be assigned automatically, and the variant will be a correct match for all searches filtered by the Size: 44 label.

Marketing and Promotions​

In addition to custom metadata (also multilingual), the variant allows for granular promotion management:

  • Promotion Exclusion: You can link specific promotions from which the variant should be excluded.
  • Coupons: You can decide whether the variant should inherit the product's discount rules or follow independent enablement logic.