Choose a version:

DeliveryPromiseParticipantOwner

union

Requires read_delivery_promises access scope.

The object that the participant references.

Anchor to Possible typesPossible types

•OBJECT

The ProductVariant object represents a version of a product that comes in more than one option, such as size or color. For example, if a merchant sells t-shirts with options for size and color, then a small, blue t-shirt would be one product variant and a large, blue t-shirt would be another.

Use the ProductVariant object to manage the full lifecycle and configuration of a product's variants. Common use cases for using the ProductVariant object include:

Tracking inventory for each variant
Setting unique prices for each variant
Assigning barcodes and SKUs to connect variants to fulfillment services
Attaching variant-specific images and media
Setting delivery and tax requirements
Supporting product bundles, subscriptions, and selling plans

A ProductVariant is associated with a parent Product object. ProductVariant serves as the central link between a product's merchandising configuration, inventory, pricing, fulfillment, and sales channels within the GraphQL Admin API schema. Each variant can reference other GraphQL types such as:

InventoryItem: Used for inventory tracking
Image: Used for variant-specific images
SellingPlanGroup: Used for subscriptions and selling plans

Learn more about Shopify's product model.

Anchor to availableForSaleavailableForSale •Boolean! non-null: Whether the product variant is available for sale.
Anchor to barcodebarcode •String: The value of the barcode associated with the product.
Anchor to compareAtPricecompareAtPrice •Money: The compare-at price of the variant in the default shop currency.
Anchor to contextualPricingcontextualPricing •ProductVariantContextualPricing! non-null: The pricing that applies for a customer in a given context. As of API version 2025-04, only active markets are considered in the price resolution.
Anchor to createdAtcreatedAt •DateTime! non-null: The date and time when the variant was created.
Anchor to defaultCursordefaultCursor •String! non-null: A default cursor that returns the single next record, sorted ascending by ID.
Anchor to deliveryProfiledeliveryProfile •DeliveryProfile: The delivery profile for the variant.
Anchor to deliveryPromiseParticipantsdeliveryPromiseParticipants •[DeliveryPromiseParticipant!]! non-null: The delivery promise participants for the product variant.
Anchor to displayNamedisplayName •String! non-null: Display name of the variant, based on product's title + variant's title.
Anchor to eventsevents •EventConnection! non-null: The paginated list of events associated with the host subject.
Anchor to idid •ID! non-null: A globally-unique ID.
Anchor to imageimage •Image: The featured image for the variant.
Anchor to inventoryIteminventoryItem •InventoryItem! non-null: The inventory item, which is used to query for inventory information.
Anchor to inventoryPolicyinventoryPolicy •ProductVariantInventoryPolicy! non-null: Whether customers are allowed to place an order for the product variant when it's out of stock.
Anchor to inventoryQuantityinventoryQuantity •Int: The total sellable quantity of the variant.
Anchor to legacyResourceIdlegacyResourceId •UnsignedInt64! non-null: The ID of the corresponding resource in the REST Admin API.
Anchor to mediamedia •MediaConnection! non-null: The media associated with the product variant.
Anchor to metafieldmetafield •Metafield: A custom field, including its namespace and key, that's associated with a Shopify resource for the purposes of adding and storing additional information.
Anchor to metafieldsmetafields •MetafieldConnection! non-null: A list of custom fields that a merchant associates with a Shopify resource.
Anchor to metafieldsByIdentifiersmetafieldsByIdentifiers •[Metafield]! non-null: The metafields associated with the resource matching the supplied list of namespaces and keys.
Anchor to positionposition •Int! non-null: The order of the product variant in the list of product variants. The first position in the list is 1.
Anchor to priceprice •Money! non-null: The price of the product variant in the default shop currency.
Anchor to productproduct •Product! non-null: The product that this variant belongs to.
Anchor to productParentsproductParents •ProductConnection! non-null: A list of products that have product variants that contain this variant as a product component.
Anchor to productVariantComponentsproductVariantComponents •ProductVariantComponentConnection! non-null: A list of the product variant components.
Anchor to requiresComponentsrequiresComponents •Boolean! non-null: Whether a product variant requires components. The default value is false. If true, then the product variant can only be purchased as a parent bundle with components and it will be omitted from channels that don't support bundles.
Anchor to selectedOptionsselectedOptions •[SelectedOption!]! non-null: List of product options applied to the variant.
Anchor to sellableOnlineQuantitysellableOnlineQuantity •Int! non-null: The total sellable quantity of the variant for online channels. This doesn't represent the total available inventory or capture limitations based on customer location.
Anchor to sellingPlanGroupssellingPlanGroups •SellingPlanGroupConnection! non-null: A list of all selling plan groups defined in the current shop associated with the product variant.
Anchor to sellingPlanGroupsCountsellingPlanGroupsCount •Count: Count of selling plan groups associated with the product variant.
Anchor to showUnitPriceshowUnitPrice •Boolean! non-null: Whether to show the unit price for this product variant.
Anchor to skusku •String: A case-sensitive identifier for the product variant in the shop. Required in order to connect to a fulfillment service.
Anchor to taxabletaxable •Boolean! non-null: Whether a tax is charged when the product variant is sold.
Anchor to titletitle •String! non-null: The title of the product variant.
Anchor to translationstranslations •[Translation!]! non-null: The published translations associated with the resource.
Anchor to unitPriceunitPrice •MoneyV2: The unit price value for the variant based on the variant measurement.
Anchor to unitPriceMeasurementunitPriceMeasurement •UnitPriceMeasurement: The unit price measurement for the variant.
Anchor to updatedAtupdatedAt •DateTime! non-null: The date and time (ISO 8601 format) when the product variant was last modified.
Anchor to metafieldDefinitionsmetafieldDefinitions •MetafieldDefinitionConnection! non-nullDeprecated
Anchor to presentmentPricespresentmentPrices •ProductVariantPricePairConnection! non-nullDeprecated
Anchor to sellingPlanGroupCountsellingPlanGroupCount •Int! non-nullDeprecated
Anchor to storefrontIdstorefrontId •StorefrontID! non-nullDeprecated
Anchor to taxCodetaxCode •String Deprecated

Was this section helpful?

Anchor to Fields with this unionFields with this union

Anchor to DeliveryPromiseParticipant.owner DeliveryPromiseParticipant.owner •OBJECT: Returns enabled delivery promise participants.

Was this section helpful?