---
title: ProductVariant - Storefront API
description: >
  A product variant represents a different version of a product, such as
  differing sizes or differing colors.
api_version: 2026-01
api_name: storefront
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/objects/ProductVariant'
  md: 'https://shopify.dev/docs/api/storefront/latest/objects/ProductVariant.md'
---

# Product​Variant

object

Requires `unauthenticated_read_product_listings` access scope.

A product variant represents a different version of a product, such as differing sizes or differing colors.

## Fields

* availableForSale
* barcode
* compareAtPrice
* components
* currentlyNotInStock
* groupedBy
* id
* image
* metafield
* metafields
* price
* product
* quantityAvailable
* quantityPriceBreaks
* quantityRule
* requiresComponents
* requiresShipping
* selectedOptions
* sellingPlanAllocations
* shopPayInstallmentsPricing
* sku
* storeAvailability
* taxable
* title
* unitPrice
* unitPriceMeasurement
* weight
* weightUnit

### Deprecated fields

* compareAtPriceV2: deprecated
* priceV2: deprecated

***

## Map

### Fields and connections with this object

* [OrderLineItem.variant](https://shopify.dev/docs/api/storefront/latest/objects/OrderLineItem#field-OrderLineItem.fields.variant)
* [Product.adjacentVariants](https://shopify.dev/docs/api/storefront/latest/objects/Product#field-Product.fields.adjacentVariants)
* [Product.selectedOrFirstAvailableVariant](https://shopify.dev/docs/api/storefront/latest/objects/Product#field-Product.fields.selectedOrFirstAvailableVariant)
* [Product.variantBySelectedOptions](https://shopify.dev/docs/api/storefront/latest/objects/Product#field-Product.fields.variantBySelectedOptions)
* [Product.variants](https://shopify.dev/docs/api/storefront/latest/objects/Product#field-Product.fields.variants)
* [ProductOptionValue.firstSelectableVariant](https://shopify.dev/docs/api/storefront/latest/objects/ProductOptionValue#field-ProductOptionValue.fields.firstSelectableVariant)
* [ProductVariant.groupedBy](https://shopify.dev/docs/api/storefront/latest/objects/ProductVariant#field-ProductVariant.fields.groupedBy)
* [ProductVariantComponent.productVariant](https://shopify.dev/docs/api/storefront/latest/objects/ProductVariantComponent#field-ProductVariantComponent.fields.productVariant)
* [ProductVariantConnection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/ProductVariantConnection#returns-nodes)
* [ProductVariantEdge.node](https://shopify.dev/docs/api/storefront/latest/objects/ProductVariantEdge#field-ProductVariantEdge.fields.node)

### Possible type in

* [Merchandise](https://shopify.dev/docs/api/storefront/latest/unions/Merchandise)
* [Metafield​Parent​Resource](https://shopify.dev/docs/api/storefront/latest/unions/MetafieldParentResource)
* [Metafield​Reference](https://shopify.dev/docs/api/storefront/latest/unions/MetafieldReference)

***

## Interfaces

* HasMetafields
* Node

***

## ProductVariant Implements

### Implements

* [Has​Metafields](https://shopify.dev/docs/api/storefront/latest/interfaces/HasMetafields)
* [Node](https://shopify.dev/docs/api/storefront/latest/interfaces/Node)