Mapping variants
Including additional fields in the
For example:
- In Sales Layer:
- In BigCommerce:
Keep the consistency between all the variants associated with the same product. Thus:
- The options must have the same attributes
- The options must be unique.
Below are included 2 examples that explain the variants synchronization in a simple way:
Only the attributes that are mapped in the connector will be exported to BigCommerce. Thus, the client can add additional fields with all the attributes used in their variants but these attributes will be created only when variants contain a value.
Please note, that if you change the attributes in SL, the previous options will remain inside the variant options in BigCommerce. Nevertheless, the variants will be replaced for the new ones.
For example, if you initially send a size “Small”:
And if you decide to change that variant to “S” inside the PIM, you will end up like:
BigCommerce Dropdown variant types
To map the
For example, a
BigCommerce Swatch variant type
The Swatch variant type is used in Color type fields and it allows mapping up to 3 different colors.
Therefore, to map these three colors the clients cansend the data with this nomenclature:
Where:
- value_name: corresponds to the color name, or mix of colors:
- #code1HEX: corresponds to the hexadecimal code of the first color:
- #code2HEX: optional value which corresponds to the hexadecimal code of the second color:
- #code3HEX: optional value which corresponds to the hexadecimal code of the third color:
Configuration of a swatch variant type in SL
The image below shows how a swatch variant type can be defined in SL:
- If the color name is sent without the corresponding hexadecimal codes, the attribute will be created as a Dropdown type instead of a Swatch variant type.
- It is mandatory to put a name for the option. Otherwise it will not be created.
- Hexadecimal codes must have 6 characters and be separated by the pound symbol (#)
- If the hexadecimal code is not sent to one of the variants, this variant will not be created. If the variant is already created in BigCommerce, it will be mapped with white color.
- Different variants of a product can have different amounts of hexadecimal codes. For example, if a variant has only one hexadecimal code, the next product variant might have two or even three codes.
- If you change the names of the values in Sales Layer, new options will be created for the field (and they will not be associated with the previous values).
Furthermore, you can map the
It is possible to send a variant field as “
If you want to send any variant as “
As a result, in your BigCommerce front-end panel you will be able to see something like this: