Shopify variants

This is for:

Developer

In Shopify, you can define a product’s variants as options when you configure the product.

The Coveo Platform indexes every Shopify variant as a separate item, with the variant options appended to the ec_name field of each one. If you have more than one variant option, the Coveo Platform indexes an item for each combination.

Note

The Coveo Platform doesn’t create fields for each variant option.

To pass variant option values to the index as Coveo fields, use Shopify metafields and select these fields to index when you sync your Shopify product catalog.

All Shopify variants are indexed as product catalog object items, and they’re grouped together using the ec_item_group_id field.

Example

The product Relaxed Top is configured with the following variant options:

  • Color (red, blue, and yellow)

  • Size (S, M, and L)

The Coveo Platform indexes items with the following ec_name values:

  • Relaxed Top - Red - S

  • Relaxed Top - Red - M

  • Relaxed Top - Red - L

  • Relaxed Top - Blue - S

  • Relaxed Top - Blue - M

  • Relaxed Top - Blue - L

  • Relaxed Top - Yellow - S

  • Relaxed Top - Yellow - M

  • Relaxed Top - Yellow - L

The Coveo Platform doesn’t create fields for each variant option. If needed, you can use Shopify metafields to pass the variant option values to the index as Coveo fields. If you do, make sure that you select these fields to index when you sync your Shopify product catalog.