Using the Storefront API, you can now narrow the collection of variants on a product based on a set of option values. This is similar to how you can refine the product node response based on option values.

For example, if a shopper selects a “Red” value from a “Color” option, you may want to display information about only the “Red” variants to them, and this allows you to request those explicitly from the API.

Consider this query:

query { site { product(entityId: 6606) { name entityId variants( optionValueIds: [{ optionEntityId: 2403, valueEntityId: 2718 }] ) { edges { node { sku defaultImage { url(width: 200) } } } } } } }