---
title: "ProductVariant"
description: "Product variant, such as a large-size red jacket."
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/storefront-api/products/objects/product-variant'
  md: 'https://developer.shopline.com/docs/storefront-api/products/objects/product-variant.md'
---
# ProductVariant

Product variant, such as a large-size red jacket.

- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Object

## Fields

* `image`

  [Image](https://developer.shopline.com/docs/storefront-api/common-objects/objects/image.md)

  The image of the variant.

* `product`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  The unique identifier for the product corresponding to the variant.

* `inventoryQuantity`

  [Int](https://developer.shopline.com/docs/storefront-api/common/scalars/int.md)

  The total inventory quantity at all storage locations.

* `~~displayName~~`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  The title of the variant, assembled from option values of the variant. [Deprecated]

* `weight`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  The weight of the variant. The value is rounded up to two decimal places.

* `~~updatedAt~~`

  [Date](https://developer.shopline.com/docs/storefront-api/common/scalars/date.md)

  The date and time when the product variant was last updated. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html). [Deprecated]

* `~~inventoryTracker~~`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  Indicates whether the inventory tracking is enabled.
  - ` true`: Inventory tracking is enabled.
  - ` false`: Inventory tracking is not enabled. [Deprecated]

* `title`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  The title of the variant, assembled from the option values of the variant.

* `~~createdAt~~`

  [Date](https://developer.shopline.com/docs/storefront-api/common/scalars/date.md)

  The creation date and time of the product variant. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html). [Deprecated]

* `price`

  [Money](https://developer.shopline.com/docs/storefront-api/common-objects/objects/money.md)

  The selling price of the variant. The value is rounded to two decimal places.

* `selectedOptions`

  [[SelectedOption]](https://developer.shopline.com/docs/storefront-api/common-objects/objects/selected-option.md)

  The options of the product variant.

* `weightUnit`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  The unit of weight for the variant. Valid values are:
  - `g`: Gram
  - `kg`: Kilogram
  - `lb`: Pound
  - `oz`: Ounce
  - `zh_kg`: Kilogram

* `sku`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  The product SKU.

* `compareAtPrice`

  [Money](https://developer.shopline.com/docs/storefront-api/common-objects/objects/money.md)

  The original price of the variant. The value is rounded to two decimal places.

* `barcode`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  The barcode of the variant.

* `availableForSale`

  [Boolean](https://developer.shopline.com/docs/storefront-api/common/scalars/boolean.md)

  Indicates whether the product variant is available for sale.
  
  - `true`: Available for sale.
  - `false`: Not available for sale.

* `~~inventoryPolicy~~`

  [ProductVariantInventoryPolicy](https://developer.shopline.com/docs/storefront-api/products/enums/product-variant-inventory-policy.md)

  Indicates whether the variant is allowed to be oversold. [Deprecated]

* `taxable`

  [Boolean](https://developer.shopline.com/docs/storefront-api/common/scalars/boolean.md)

  Indicates whether the variant is subject to tax.
  
  - `true`: Tax is required.
  - `false`: Tax is not required.

* `requiresShipping`

  [Boolean](https://developer.shopline.com/docs/storefront-api/common/scalars/boolean.md)

  Indicates whether the variant is required to be shipped.
  
  - `true`: Shipping is required.
  - `false`: Shipping is not required.

* `metafield`

  [Metafield](https://developer.shopline.com/docs/storefront-api/common-objects/objects/metafield.md)

  A metafield associated with the product variant.

* `metafields`

  [[Metafield]](https://developer.shopline.com/docs/storefront-api/common-objects/objects/metafield.md)

  Metafields associated with the product variant.

* `parentProduct`

  [Product](https://developer.shopline.com/docs/storefront-api/products/objects/product.md)

  The parent product object of the product variant.

* `storeAvailability`

  [StoreAvailabilityConnection](https://developer.shopline.com/docs/storefront-api/products/objects/store-availability-connection.md)

  Inventory status of the product variant.

* `requiresSellingPlan`

  [Boolean](https://developer.shopline.com/docs/storefront-api/common/scalars/boolean.md)

  Whether the product variant can only be purchased with a selling plan.
  
  - `true`: Can only be purchased with a selling plan.
  - `false`: Can be purchased not through a selling plan.

* `sellingPlanAllocations`

  [SellingPlanAllocationConnection](https://developer.shopline.com/docs/storefront-api/products/objects/selling-plan-allocation-connection.md)

  Selling plan allocations available for the variant.

## Field from

* [ProductVariantEdge](https://developer.shopline.com/docs/storefront-api/products/objects/product-variant-edge.md).node

* [ProductVariantConnection](https://developer.shopline.com/docs/storefront-api/products/objects/product-variant-connection.md).nodes

* [CartLine](https://developer.shopline.com/docs/storefront-api/cart/objects/cart-line.md).productVariant

* [Product](https://developer.shopline.com/docs/storefront-api/products/objects/product.md).selectedOrFirstAvailableVariant

* [Product](https://developer.shopline.com/docs/storefront-api/products/objects/product.md).variants

* [OrderLineItem](https://developer.shopline.com/docs/storefront-api/common-objects/objects/order-line-item.md).variant

* [Query](https://developer.shopline.com/docs/storefront-api/products/queries/proxy-node-product-variant.md).proxyNodeProductVariant