---
title: ProductVariantConnection - Storefront API
description: |
  An auto-generated type for paginating through multiple ProductVariants.
api_version: 2026-01
api_name: storefront
type: connection
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/latest/connections/ProductVariantConnection
  md: >-
    https://shopify.dev/docs/api/storefront/latest/connections/ProductVariantConnection.md
---

# Product​Variant​Connection

connection

An auto-generated type for paginating through multiple ProductVariants.

## Fields with this connection

* [Product.variants](https://shopify.dev/docs/api/storefront/latest/objects/Product#field-Product.fields.variants)

  OBJECT

  Represents an item listed in a shop's catalog.

  Products support multiple [product variants](https://shopify.dev/docs/api/storefront/current/objects/ProductVariant), representing different versions of the same product, and can include various [media](https://shopify.dev/docs/api/storefront/current/interfaces/Media) types. Use the [`selectedOrFirstAvailableVariant`](https://shopify.dev/docs/api/storefront/current/objects/Product#field-Product.fields.selectedOrFirstAvailableVariant) or [`variantBySelectedOptions`](https://shopify.dev/docs/api/storefront/current/objects/Product#field-Product.fields.variantBySelectedOptions) fields to help customers find the right variant based on their selections.

  Products can be organized into [collections](https://shopify.dev/docs/api/storefront/current/objects/Collection), associated with [selling plans](https://shopify.dev/docs/api/storefront/current/objects/SellingPlanGroup) for subscriptions, and extended with custom data through [metafields](https://shopify.dev/docs/api/storefront/current/objects/Metafield).

  Learn more about working with [products and collections](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/products-collections).

* [Product​Variant.groupedBy](https://shopify.dev/docs/api/storefront/latest/objects/ProductVariant#field-ProductVariant.fields.groupedBy)

  OBJECT

  A specific version of a [product](https://shopify.dev/docs/api/storefront/current/objects/Product) available for sale, differentiated by options like size or color. For example, a small blue t-shirt and a large blue t-shirt are separate variants of the same product. For more information, see the docs on [Shopify's product model](https://shopify.dev/docs/apps/build/product-merchandising/products-and-collections).

  For products with quantity rules, variants enforce minimum, maximum, and increment constraints on purchases.

  Variants also support subscriptions and pre-orders through [selling plan allocations](https://shopify.dev/docs/api/storefront/current/objects/SellingPlanAllocation) objects, bundle configurations through [product variant components](https://shopify.dev/docs/api/storefront/current/objects/ProductVariantComponent) objects, and [shop pay installments pricing](https://shopify.dev/docs/api/storefront/current/objects/ShopPayInstallmentsPricing) for flexible payment options.

***

## Possible returns

* edges

  [\[Product​Variant​Edge!\]!](https://shopify.dev/docs/api/storefront/latest/objects/ProductVariantEdge)

  non-null

  A list of edges.

* nodes

  [\[Product​Variant!\]!](https://shopify.dev/docs/api/storefront/latest/objects/ProductVariant)

  non-null

  A list of the nodes contained in ProductVariantEdge.

* page​Info

  [Page​Info!](https://shopify.dev/docs/api/storefront/latest/objects/PageInfo)

  non-null

  Information to aid in pagination.

***

## Map

### Fields with this connection

* [Product.variants](https://shopify.dev/docs/api/storefront/latest/objects/Product#field-Product.fields.variants)
* [Product​Variant.groupedBy](https://shopify.dev/docs/api/storefront/latest/objects/ProductVariant#field-ProductVariant.fields.groupedBy)

### Possible returns

* [Product​Variant​Connection.edges](https://shopify.dev/docs/api/storefront/latest/connections/ProductVariantConnection#returns-edges)
* [Product​Variant​Connection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/ProductVariantConnection#returns-nodes)
* [Product​Variant​Connection.pageInfo](https://shopify.dev/docs/api/storefront/latest/connections/ProductVariantConnection#returns-pageInfo)