Product Variant

Version 2019-04

Important

Apps can no longer set inventory using inventory_quantity or inventory_quantity_adjustment. For more information, see Updating inventory.

A variant can be added to a Product resource to represent one version of a product with several options. The Product resource will have a variant for every possible combination of its options. Each product can have a maximum of three options and a maximum of 100 variants.

What you can do with Product Variant

The Shopify API lets you do the following with the Product Variant resource. More detailed versions of these general actions may be available:

GET /admin/api/2019-04/products/#{product_id}/variants.json Retrieves a list of product variants
GET /admin/api/2019-04/products/#{product_id}/variants/count.json Receive a count of all Product Variants
GET /admin/api/2019-04/variants/#{variant_id}.json Receive a single Product Variant
POST /admin/api/2019-04/products/#{product_id}/variants.json Create a new Product Variant
PUT /admin/api/2019-04/variants/#{variant_id}.json Modify an existing Product Variant
DELETE /admin/api/2019-04/products/#{product_id}/variants/#{variant_id}.json Remove an existing Product Variant

Product Variant properties

barcode	`"barcode": "1234_pink"` The barcode, UPC, or ISBN number for the product.
compare_at_price	`"compare_at_price": "299.00"` The original price of the item before an adjustment or a sale.
created_at	`"created_at": "2012-08-24T14:01:47-04:00"` The date and time (ISO 8601 format) when the product variant was created.
fulfillment_service	`"fulfillment_service": "manual"` The fulfillment service associated with the product variant. Valid values: `manual` or the handle of a fulfillment service.
grams	`"grams": 567` The weight of the product variant in grams.
id	`"id": 808950810` The unique numeric identifier for the product variant.
image_id	`"image_id": 434522` The unique numeric identifier for a product's image. The image must be associated to the same product as the variant.
inventory_item_id	`"inventory_item_id": 342916` The unique identifier for the inventory item, which is used in the Inventory API to query for inventory information.
inventory_management	`"inventory_management": "shopify"` The fulfillment service that tracks the number of items in stock for the product variant. If you track the inventory yourself using the admin, then set the value to "shopify". Valid values: `shopify` or the handle of a fulfillment service that has inventory management enabled. Must be the same fulfillment service referenced by the `fulfillment_service` property.
inventory_policy	`"inventory_policy": "continue"` Whether customers are allowed to place an order for the product variant when it's out of stock. Valid values: `deny`: Customers are not allowed to place orders for the product variant if it's out of stock. `continue`: Customers are allowed to place orders for the product variant if it's out of stock. Default value: `deny`.
inventory_quantity read-only	`"inventory_quantity": 10` An aggregate of inventory across all locations. To adjust inventory at a specific location, use the InventoryLevel resource.
old_inventory_quantity deprecated	`"old_inventory_quantity": 5` This property is deprecated. Use the InventoryLevel resource instead.
inventory_quantity_adjustment deprecated	`"inventory_quantity_adjustment": 5` This property is deprecated. Use the InventoryLevel resource instead.
option	`"option1": "Pink"` The custom properties that a shop owner uses to define product variants. You can define three options for a product: `option1`, `option2`, `option3`. Default value: `Default Title`.
presentment_prices	"presentment_prices": [ { "price": { "currency_code": "USD", "amount": "199.99" }, "compare_at_price": { "currency_code": "USD", "amount": "249.99" } }, { "price": { "currency_code": "EUR", "amount": "158.95" }, "compare_at_price": { "currency_code": "EUR", "amount": "198.95" } }, { "price": { "currency_code": "GBP", "amount": "143.00" }, "compare_at_price": { "currency_code": "GBP", "amount": "179.00" } }, { "price": { "currency_code": "JPY", "amount": "22400" }, "compare_at_price": { "currency_code": "JPY", "amount": "28000" } } ] A list of the variant's presentment prices and compare-at prices in each of the shop's enabled presentment currencies. Each price object has the following properties: `currency_code`: The three-letter code (ISO 4217 format) for one of the shop's enabled presentment currencies. `amount`: The variant's price or compare-at price in the presentment currency. Requires the header `'X-Shopify-Api-Features': 'include-presentment-prices'`.
position read-only	`"position": 1` The order of the product variant in the list of product variants. The first position in the list is `1`. The position of variants is indicated by the order in which they are listed.
price	`"price": "199.00"` The price of the product variant.
product_id	`"product_id": 632910392` The unique numeric identifier for the product.
requires_shipping deprecated	`"requires_shipping": true` Whether a customer needs to provide a shipping address when placing an order for the product variant.
sku	`"sku": "IPOD2008PINK"` A unique identifier for the product variant in the shop. Required in order to connect to a FulfillmentService.
taxable	`"taxable": true` Whether a tax is charged when the product variant is sold.
tax_code	`"tax_code": "DA040000"` This parameter applies only to the stores that have the Avalara AvaTax app installed. Specifies the Avalara tax code for the product variant.
title	`"title": "Pink"` The title of the product variant.
updated_at	`"updated_at": "2012-08-24T14:01:47-04:00"` The date and time when the product variant was last modified. Gets returned in ISO 8601 format.
weight	`"weight": 100` The weight of the product variant in the unit system specified with `weight_unit`.
weight_unit	`"weight_unit": "oz"` The unit of measurement that applies to the product variant's weight. If you don't specify a value for `weight_unit`, then the shop's default unit of measurement is applied. Valid values: `g`, `kg`, `oz`, and `lb`.

Endpoints

GET /admin/api/2019-04/products/#{product_id}/variants.json

Retrieves a list of product variants.

limit	Return up to this many results per page (default: `50`, maximum: `250`)
page deprecated	The page of results to show. Removed in version 2019-10. Use [cursor-based pagination](/tutorials/make-paginated-requests-to-rest-admin-api) instead. Sending this parameter will return an error. (default: `1`)
presentment_currencies	Return presentment prices in only certain currencies, specified by a comma-separated list of ISO 4217 currency codes.
since_id	Restrict results to after the specified ID
fields	A comma-separated list of fields to include in the response

Retrieve all variants for a product

GET /admin/api/2019-04/products/#{product_id}/variants.json

View Response

HTTP/1.1 200 OK
{
  "variants": [
    {
      "id": 39072856,
      "product_id": 632910392,
      "title": "Green",
      "price": "199.00",
      "sku": "IPOD2008GREEN",
      "position": 3,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Green",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_green",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 39072856,
      "inventory_quantity": 30,
      "old_inventory_quantity": 30,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 49148385,
      "product_id": 632910392,
      "title": "Red",
      "price": "199.00",
      "sku": "IPOD2008RED",
      "position": 2,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Red",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_red",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 49148385,
      "inventory_quantity": 20,
      "old_inventory_quantity": 20,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 457924702,
      "product_id": 632910392,
      "title": "Black",
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "position": 4,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Black",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_black",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 457924702,
      "inventory_quantity": 40,
      "old_inventory_quantity": 40,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 808950810,
      "product_id": 632910392,
      "title": "Pink",
      "price": "199.00",
      "sku": "IPOD2008PINK",
      "position": 1,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Pink",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_pink",
      "grams": 567,
      "image_id": 562641783,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 808950810,
      "inventory_quantity": 10,
      "old_inventory_quantity": 10,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    }
  ]
}

Retrieve all variants for a product after a specified ID

GET /admin/api/2019-04/products/#{product_id}/variants.json?since_id=49148385

View Response

HTTP/1.1 200 OK
{
  "variants": [
    {
      "id": 457924702,
      "product_id": 632910392,
      "title": "Black",
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "position": 4,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Black",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_black",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 457924702,
      "inventory_quantity": 40,
      "old_inventory_quantity": 40,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 808950810,
      "product_id": 632910392,
      "title": "Pink",
      "price": "199.00",
      "sku": "IPOD2008PINK",
      "position": 1,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Pink",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_pink",
      "grams": 567,
      "image_id": 562641783,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 808950810,
      "inventory_quantity": 10,
      "old_inventory_quantity": 10,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    }
  ]
}

Retrieve all variants for a product with prices in specified presentment currencies

GET /admin/api/2019-04/products/#{product_id}/variants.json?presentment_currencies=USD,CAD

View Response

HTTP/1.1 200 OK
{
  "variants": [
    {
      "id": 39072856,
      "product_id": 632910392,
      "title": "Green",
      "price": "199.00",
      "sku": "IPOD2008GREEN",
      "position": 3,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Green",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_green",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 39072856,
      "inventory_quantity": 30,
      "old_inventory_quantity": 30,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": {
            "currency_code": "USD",
            "amount": "249.00"
          }
        },
        {
          "price": {
            "currency_code": "CAD",
            "amount": "248.75"
          },
          "compare_at_price": {
            "currency_code": "CAD",
            "amount": "311.25"
          }
        }
      ]
    },
    {
      "id": 49148385,
      "product_id": 632910392,
      "title": "Red",
      "price": "199.00",
      "sku": "IPOD2008RED",
      "position": 2,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Red",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_red",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 49148385,
      "inventory_quantity": 20,
      "old_inventory_quantity": 20,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": {
            "currency_code": "USD",
            "amount": "249.00"
          }
        },
        {
          "price": {
            "currency_code": "CAD",
            "amount": "248.75"
          },
          "compare_at_price": {
            "currency_code": "CAD",
            "amount": "311.25"
          }
        }
      ]
    },
    {
      "id": 457924702,
      "product_id": 632910392,
      "title": "Black",
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "position": 4,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Black",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_black",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 457924702,
      "inventory_quantity": 40,
      "old_inventory_quantity": 40,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": {
            "currency_code": "USD",
            "amount": "249.00"
          }
        },
        {
          "price": {
            "currency_code": "CAD",
            "amount": "248.75"
          },
          "compare_at_price": {
            "currency_code": "CAD",
            "amount": "311.25"
          }
        }
      ]
    },
    {
      "id": 808950810,
      "product_id": 632910392,
      "title": "Pink",
      "price": "199.00",
      "sku": "IPOD2008PINK",
      "position": 1,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Pink",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_pink",
      "grams": 567,
      "image_id": 562641783,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 808950810,
      "inventory_quantity": 10,
      "old_inventory_quantity": 10,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": {
            "currency_code": "USD",
            "amount": "249.00"
          }
        },
        {
          "price": {
            "currency_code": "CAD",
            "amount": "248.75"
          },
          "compare_at_price": {
            "currency_code": "CAD",
            "amount": "311.25"
          }
        }
      ]
    }
  ]
}

GET /admin/api/2019-04/products/#{product_id}/variants/count.json

Retrieves a count of product variants

Retrieve a count all variants for a product

GET /admin/api/2019-04/products/#{product_id}/variants/count.json

View Response

HTTP/1.1 200 OK
{
  "count": 4
}

GET /admin/api/2019-04/variants/#{variant_id}.json

Retrieves a single product variant by ID

fields

A comma-separated list of fields to include in the response

Retrieve a product variant by ID

GET /admin/api/2019-04/variants/#{variant_id}.json

View Response

HTTP/1.1 200 OK
{
  "variant": {
    "id": 808950810,
    "product_id": 632910392,
    "title": "Pink",
    "price": "199.00",
    "sku": "IPOD2008PINK",
    "position": 1,
    "inventory_policy": "continue",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Pink",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:35-05:00",
    "updated_at": "2020-03-04T12:44:35-05:00",
    "taxable": true,
    "barcode": "1234_pink",
    "grams": 567,
    "image_id": 562641783,
    "weight": 1.25,
    "weight_unit": "lb",
    "inventory_item_id": 808950810,
    "inventory_quantity": 10,
    "old_inventory_quantity": 10,
    "tax_code": "DA040000",
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "199.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

POST /admin/api/2019-04/products/#{product_id}/variants.json

Creates a new product variant

Create a new product variant

POST /admin/api/2019-04/products/#{product_id}/variants.json

{
  "variant": {
    "option1": "Yellow",
    "price": "1.00"
  }
}

View Response

HTTP/1.1 201 Created
{
  "variant": {
    "id": 1070325047,
    "product_id": 632910392,
    "title": "Yellow",
    "price": "1.00",
    "sku": "",
    "position": 5,
    "inventory_policy": "deny",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Yellow",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:48-05:00",
    "updated_at": "2020-03-04T12:44:48-05:00",
    "taxable": true,
    "barcode": null,
    "grams": 0,
    "image_id": null,
    "weight": 0.0,
    "weight_unit": "lb",
    "inventory_item_id": 1070325051,
    "inventory_quantity": 0,
    "old_inventory_quantity": 0,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325047",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "1.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

Create a new product variant with a metafield

POST /admin/api/2019-04/products/#{product_id}/variants.json

{
  "variant": {
    "option1": "Blue",
    "metafields": [
      {
        "key": "new",
        "value": "newvalue",
        "value_type": "string",
        "namespace": "global"
      }
    ]
  }
}

View Response

HTTP/1.1 201 Created
{
  "variant": {
    "id": 1070325048,
    "product_id": 632910392,
    "title": "Blue",
    "price": "0.00",
    "sku": "",
    "position": 5,
    "inventory_policy": "deny",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Blue",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:49-05:00",
    "updated_at": "2020-03-04T12:44:49-05:00",
    "taxable": true,
    "barcode": null,
    "grams": 0,
    "image_id": null,
    "weight": 0.0,
    "weight_unit": "lb",
    "inventory_item_id": 1070325052,
    "inventory_quantity": 0,
    "old_inventory_quantity": 0,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325048",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "0.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

Create a new product variant with an image

POST /admin/api/2019-04/products/#{product_id}/variants.json

{
  "variant": {
    "image_id": 850703190,
    "option1": "Purple"
  }
}

View Response

HTTP/1.1 201 Created
{
  "variant": {
    "id": 1070325049,
    "product_id": 632910392,
    "title": "Purple",
    "price": "0.00",
    "sku": "",
    "position": 5,
    "inventory_policy": "deny",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Purple",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:50-05:00",
    "updated_at": "2020-03-04T12:44:50-05:00",
    "taxable": true,
    "barcode": null,
    "grams": 0,
    "image_id": 850703190,
    "weight": 0.0,
    "weight_unit": "lb",
    "inventory_item_id": 1070325053,
    "inventory_quantity": 0,
    "old_inventory_quantity": 0,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325049",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "0.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

PUT /admin/api/2019-04/variants/#{variant_id}.json

Updates an existing product variant

Update the title and price of an existing variant

PUT /admin/api/2019-04/variants/#{variant_id}.json

{
  "variant": {
    "id": 808950810,
    "option1": "Not Pink",
    "price": "99.00"
  }
}

View Response

HTTP/1.1 200 OK
{
  "variant": {
    "id": 808950810,
    "product_id": 632910392,
    "title": "Not Pink",
    "price": "99.00",
    "sku": "IPOD2008PINK",
    "position": 1,
    "inventory_policy": "continue",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Not Pink",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:35-05:00",
    "updated_at": "2020-03-04T12:44:50-05:00",
    "taxable": true,
    "barcode": "1234_pink",
    "grams": 567,
    "image_id": 562641783,
    "weight": 1.25,
    "weight_unit": "lb",
    "inventory_item_id": 808950810,
    "inventory_quantity": 10,
    "old_inventory_quantity": 10,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "99.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

Add a metafield to an existing variant

PUT /admin/api/2019-04/variants/#{variant_id}.json

{
  "variant": {
    "id": 808950810,
    "metafields": [
      {
        "key": "new",
        "value": "newvalue",
        "value_type": "string",
        "namespace": "global"
      }
    ]
  }
}

View Response

HTTP/1.1 200 OK
{
  "variant": {
    "id": 808950810,
    "product_id": 632910392,
    "title": "Pink",
    "price": "199.00",
    "sku": "IPOD2008PINK",
    "position": 1,
    "inventory_policy": "continue",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Pink",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:35-05:00",
    "updated_at": "2020-03-04T12:44:51-05:00",
    "taxable": true,
    "barcode": "1234_pink",
    "grams": 567,
    "image_id": 562641783,
    "weight": 1.25,
    "weight_unit": "lb",
    "inventory_item_id": 808950810,
    "inventory_quantity": 10,
    "old_inventory_quantity": 10,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "199.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

Add an existing image to an existing variant

PUT /admin/api/2019-04/variants/#{variant_id}.json

{
  "variant": {
    "id": 808950810,
    "image_id": 562641783
  }
}

View Response

HTTP/1.1 200 OK
{
  "variant": {
    "id": 808950810,
    "product_id": 632910392,
    "title": "Pink",
    "price": "199.00",
    "sku": "IPOD2008PINK",
    "position": 1,
    "inventory_policy": "continue",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Pink",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:35-05:00",
    "updated_at": "2020-03-04T12:44:52-05:00",
    "taxable": true,
    "barcode": "1234_pink",
    "grams": 567,
    "image_id": 562641783,
    "weight": 1.25,
    "weight_unit": "lb",
    "inventory_item_id": 808950810,
    "inventory_quantity": 10,
    "old_inventory_quantity": 10,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "199.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

DELETE /admin/api/2019-04/products/#{product_id}/variants/#{variant_id}.json

Delete a product variant

DELETE /admin/api/2019-04/products/#{product_id}/variants/#{variant_id}.json

View Response

HTTP/1.1 200 OK
{
}

Version 2019-07

Important

Apps can no longer set inventory using inventory_quantity or inventory_quantity_adjustment. For more information, see Updating inventory.

What you can do with Product Variant

The Shopify API lets you do the following with the Product Variant resource. More detailed versions of these general actions may be available:

GET /admin/api/2019-07/products/#{product_id}/variants.json Retrieves a list of product variants
GET /admin/api/2019-07/products/#{product_id}/variants/count.json Receive a count of all Product Variants
GET /admin/api/2019-07/variants/#{variant_id}.json Receive a single Product Variant
POST /admin/api/2019-07/products/#{product_id}/variants.json Create a new Product Variant
PUT /admin/api/2019-07/variants/#{variant_id}.json Modify an existing Product Variant
DELETE /admin/api/2019-07/products/#{product_id}/variants/#{variant_id}.json Remove an existing Product Variant

Product Variant properties

barcode	`"barcode": "1234_pink"` The barcode, UPC, or ISBN number for the product.
compare_at_price	`"compare_at_price": "299.00"` The original price of the item before an adjustment or a sale.
created_at	`"created_at": "2012-08-24T14:01:47-04:00"` The date and time (ISO 8601 format) when the product variant was created.
fulfillment_service	`"fulfillment_service": "manual"` The fulfillment service associated with the product variant. Valid values: `manual` or the handle of a fulfillment service.
grams	`"grams": 567` The weight of the product variant in grams.
id	`"id": 808950810` The unique numeric identifier for the product variant.
image_id	`"image_id": 434522` The unique numeric identifier for a product's image. The image must be associated to the same product as the variant.
inventory_item_id	`"inventory_item_id": 342916` The unique identifier for the inventory item, which is used in the Inventory API to query for inventory information.
inventory_management	`"inventory_management": "shopify"` The fulfillment service that tracks the number of items in stock for the product variant. If you track the inventory yourself using the admin, then set the value to "shopify". Valid values: `shopify` or the handle of a fulfillment service that has inventory management enabled. Must be the same fulfillment service referenced by the `fulfillment_service` property.
inventory_policy	`"inventory_policy": "continue"` Whether customers are allowed to place an order for the product variant when it's out of stock. Valid values: `deny`: Customers are not allowed to place orders for the product variant if it's out of stock. `continue`: Customers are allowed to place orders for the product variant if it's out of stock. Default value: `deny`.
inventory_quantity read-only	`"inventory_quantity": 10` An aggregate of inventory across all locations. To adjust inventory at a specific location, use the InventoryLevel resource.
old_inventory_quantity deprecated	`"old_inventory_quantity": 5` This property is deprecated. Use the InventoryLevel resource instead.
inventory_quantity_adjustment deprecated	`"inventory_quantity_adjustment": 5` This property is deprecated. Use the InventoryLevel resource instead.
option	`"option1": "Pink"` The custom properties that a shop owner uses to define product variants. You can define three options for a product: `option1`, `option2`, `option3`. Default value: `Default Title`.
presentment_prices	"presentment_prices": [ { "price": { "currency_code": "USD", "amount": "199.99" }, "compare_at_price": { "currency_code": "USD", "amount": "249.99" } }, { "price": { "currency_code": "EUR", "amount": "158.95" }, "compare_at_price": { "currency_code": "EUR", "amount": "198.95" } }, { "price": { "currency_code": "GBP", "amount": "143.00" }, "compare_at_price": { "currency_code": "GBP", "amount": "179.00" } }, { "price": { "currency_code": "JPY", "amount": "22400" }, "compare_at_price": { "currency_code": "JPY", "amount": "28000" } } ] A list of the variant's presentment prices and compare-at prices in each of the shop's enabled presentment currencies. Each price object has the following properties: `currency_code`: The three-letter code (ISO 4217 format) for one of the shop's enabled presentment currencies. `amount`: The variant's price or compare-at price in the presentment currency. Requires the header `'X-Shopify-Api-Features': 'include-presentment-prices'`.
position read-only	`"position": 1` The order of the product variant in the list of product variants. The first position in the list is `1`. The position of variants is indicated by the order in which they are listed.
price	`"price": "199.00"` The price of the product variant.
product_id	`"product_id": 632910392` The unique numeric identifier for the product.
requires_shipping deprecated	`"requires_shipping": true` Whether a customer needs to provide a shipping address when placing an order for the product variant.
sku	`"sku": "IPOD2008PINK"` A unique identifier for the product variant in the shop. Required in order to connect to a FulfillmentService.
taxable	`"taxable": true` Whether a tax is charged when the product variant is sold.
tax_code	`"tax_code": "DA040000"` This parameter applies only to the stores that have the Avalara AvaTax app installed. Specifies the Avalara tax code for the product variant.
title	`"title": "Pink"` The title of the product variant.
updated_at	`"updated_at": "2012-08-24T14:01:47-04:00"` The date and time when the product variant was last modified. Gets returned in ISO 8601 format.
weight	`"weight": 100` The weight of the product variant in the unit system specified with `weight_unit`.
weight_unit	`"weight_unit": "oz"` The unit of measurement that applies to the product variant's weight. If you don't specify a value for `weight_unit`, then the shop's default unit of measurement is applied. Valid values: `g`, `kg`, `oz`, and `lb`.

Endpoints

GET /admin/api/2019-07/products/#{product_id}/variants.json

Retrieves a list of product variants.

limit	Return up to this many results per page (default: `50`, maximum: `250`)
page deprecated	The page of results to show. Removed in version 2019-10. Use [cursor-based pagination](/tutorials/make-paginated-requests-to-rest-admin-api) instead. Sending this parameter will return an error. (default: `1`)
presentment_currencies	Return presentment prices in only certain currencies, specified by a comma-separated list of ISO 4217 currency codes.
since_id	Restrict results to after the specified ID
fields	A comma-separated list of fields to include in the response

Retrieve all variants for a product

GET /admin/api/2019-07/products/#{product_id}/variants.json

View Response

HTTP/1.1 200 OK
{
  "variants": [
    {
      "id": 39072856,
      "product_id": 632910392,
      "title": "Green",
      "price": "199.00",
      "sku": "IPOD2008GREEN",
      "position": 3,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Green",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_green",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 39072856,
      "inventory_quantity": 30,
      "old_inventory_quantity": 30,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 49148385,
      "product_id": 632910392,
      "title": "Red",
      "price": "199.00",
      "sku": "IPOD2008RED",
      "position": 2,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Red",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_red",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 49148385,
      "inventory_quantity": 20,
      "old_inventory_quantity": 20,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 457924702,
      "product_id": 632910392,
      "title": "Black",
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "position": 4,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Black",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_black",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 457924702,
      "inventory_quantity": 40,
      "old_inventory_quantity": 40,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 808950810,
      "product_id": 632910392,
      "title": "Pink",
      "price": "199.00",
      "sku": "IPOD2008PINK",
      "position": 1,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Pink",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_pink",
      "grams": 567,
      "image_id": 562641783,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 808950810,
      "inventory_quantity": 10,
      "old_inventory_quantity": 10,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    }
  ]
}

Retrieve all variants for a product after a specified ID

GET /admin/api/2019-07/products/#{product_id}/variants.json?since_id=49148385

View Response

HTTP/1.1 200 OK
{
  "variants": [
    {
      "id": 457924702,
      "product_id": 632910392,
      "title": "Black",
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "position": 4,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Black",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_black",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 457924702,
      "inventory_quantity": 40,
      "old_inventory_quantity": 40,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 808950810,
      "product_id": 632910392,
      "title": "Pink",
      "price": "199.00",
      "sku": "IPOD2008PINK",
      "position": 1,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Pink",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_pink",
      "grams": 567,
      "image_id": 562641783,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 808950810,
      "inventory_quantity": 10,
      "old_inventory_quantity": 10,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    }
  ]
}

Retrieve all variants for a product with prices in specified presentment currencies

GET /admin/api/2019-07/products/#{product_id}/variants.json?presentment_currencies=USD,CAD

View Response

HTTP/1.1 200 OK
{
  "variants": [
    {
      "id": 39072856,
      "product_id": 632910392,
      "title": "Green",
      "price": "199.00",
      "sku": "IPOD2008GREEN",
      "position": 3,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Green",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_green",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 39072856,
      "inventory_quantity": 30,
      "old_inventory_quantity": 30,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": {
            "currency_code": "USD",
            "amount": "249.00"
          }
        },
        {
          "price": {
            "currency_code": "CAD",
            "amount": "248.75"
          },
          "compare_at_price": {
            "currency_code": "CAD",
            "amount": "311.25"
          }
        }
      ]
    },
    {
      "id": 49148385,
      "product_id": 632910392,
      "title": "Red",
      "price": "199.00",
      "sku": "IPOD2008RED",
      "position": 2,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Red",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_red",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 49148385,
      "inventory_quantity": 20,
      "old_inventory_quantity": 20,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": {
            "currency_code": "USD",
            "amount": "249.00"
          }
        },
        {
          "price": {
            "currency_code": "CAD",
            "amount": "248.75"
          },
          "compare_at_price": {
            "currency_code": "CAD",
            "amount": "311.25"
          }
        }
      ]
    },
    {
      "id": 457924702,
      "product_id": 632910392,
      "title": "Black",
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "position": 4,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Black",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_black",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 457924702,
      "inventory_quantity": 40,
      "old_inventory_quantity": 40,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": {
            "currency_code": "USD",
            "amount": "249.00"
          }
        },
        {
          "price": {
            "currency_code": "CAD",
            "amount": "248.75"
          },
          "compare_at_price": {
            "currency_code": "CAD",
            "amount": "311.25"
          }
        }
      ]
    },
    {
      "id": 808950810,
      "product_id": 632910392,
      "title": "Pink",
      "price": "199.00",
      "sku": "IPOD2008PINK",
      "position": 1,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Pink",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_pink",
      "grams": 567,
      "image_id": 562641783,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 808950810,
      "inventory_quantity": 10,
      "old_inventory_quantity": 10,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": {
            "currency_code": "USD",
            "amount": "249.00"
          }
        },
        {
          "price": {
            "currency_code": "CAD",
            "amount": "248.75"
          },
          "compare_at_price": {
            "currency_code": "CAD",
            "amount": "311.25"
          }
        }
      ]
    }
  ]
}

GET /admin/api/2019-07/products/#{product_id}/variants/count.json

Retrieves a count of product variants

Retrieve a count all variants for a product

GET /admin/api/2019-07/products/#{product_id}/variants/count.json

View Response

HTTP/1.1 200 OK
{
  "count": 4
}

GET /admin/api/2019-07/variants/#{variant_id}.json

Retrieves a single product variant by ID

fields

A comma-separated list of fields to include in the response

Retrieve a product variant by ID

GET /admin/api/2019-07/variants/#{variant_id}.json

View Response

HTTP/1.1 200 OK
{
  "variant": {
    "id": 808950810,
    "product_id": 632910392,
    "title": "Pink",
    "price": "199.00",
    "sku": "IPOD2008PINK",
    "position": 1,
    "inventory_policy": "continue",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Pink",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:35-05:00",
    "updated_at": "2020-03-04T12:44:35-05:00",
    "taxable": true,
    "barcode": "1234_pink",
    "grams": 567,
    "image_id": 562641783,
    "weight": 1.25,
    "weight_unit": "lb",
    "inventory_item_id": 808950810,
    "inventory_quantity": 10,
    "old_inventory_quantity": 10,
    "tax_code": "DA040000",
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "199.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

POST /admin/api/2019-07/products/#{product_id}/variants.json

Creates a new product variant

Create a new product variant

POST /admin/api/2019-07/products/#{product_id}/variants.json

{
  "variant": {
    "option1": "Yellow",
    "price": "1.00"
  }
}

View Response

HTTP/1.1 201 Created
{
  "variant": {
    "id": 1070325047,
    "product_id": 632910392,
    "title": "Yellow",
    "price": "1.00",
    "sku": "",
    "position": 5,
    "inventory_policy": "deny",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Yellow",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:48-05:00",
    "updated_at": "2020-03-04T12:44:48-05:00",
    "taxable": true,
    "barcode": null,
    "grams": 0,
    "image_id": null,
    "weight": 0.0,
    "weight_unit": "lb",
    "inventory_item_id": 1070325051,
    "inventory_quantity": 0,
    "old_inventory_quantity": 0,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325047",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "1.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

Create a new product variant with a metafield

POST /admin/api/2019-07/products/#{product_id}/variants.json

{
  "variant": {
    "option1": "Blue",
    "metafields": [
      {
        "key": "new",
        "value": "newvalue",
        "value_type": "string",
        "namespace": "global"
      }
    ]
  }
}

View Response

HTTP/1.1 201 Created
{
  "variant": {
    "id": 1070325048,
    "product_id": 632910392,
    "title": "Blue",
    "price": "0.00",
    "sku": "",
    "position": 5,
    "inventory_policy": "deny",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Blue",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:49-05:00",
    "updated_at": "2020-03-04T12:44:49-05:00",
    "taxable": true,
    "barcode": null,
    "grams": 0,
    "image_id": null,
    "weight": 0.0,
    "weight_unit": "lb",
    "inventory_item_id": 1070325052,
    "inventory_quantity": 0,
    "old_inventory_quantity": 0,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325048",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "0.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

Create a new product variant with an image

POST /admin/api/2019-07/products/#{product_id}/variants.json

{
  "variant": {
    "image_id": 850703190,
    "option1": "Purple"
  }
}

View Response

HTTP/1.1 201 Created
{
  "variant": {
    "id": 1070325049,
    "product_id": 632910392,
    "title": "Purple",
    "price": "0.00",
    "sku": "",
    "position": 5,
    "inventory_policy": "deny",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Purple",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:50-05:00",
    "updated_at": "2020-03-04T12:44:50-05:00",
    "taxable": true,
    "barcode": null,
    "grams": 0,
    "image_id": 850703190,
    "weight": 0.0,
    "weight_unit": "lb",
    "inventory_item_id": 1070325053,
    "inventory_quantity": 0,
    "old_inventory_quantity": 0,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325049",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "0.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

PUT /admin/api/2019-07/variants/#{variant_id}.json

Updates an existing product variant

Update the title and price of an existing variant

PUT /admin/api/2019-07/variants/#{variant_id}.json

{
  "variant": {
    "id": 808950810,
    "option1": "Not Pink",
    "price": "99.00"
  }
}

View Response

HTTP/1.1 200 OK
{
  "variant": {
    "id": 808950810,
    "product_id": 632910392,
    "title": "Not Pink",
    "price": "99.00",
    "sku": "IPOD2008PINK",
    "position": 1,
    "inventory_policy": "continue",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Not Pink",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:35-05:00",
    "updated_at": "2020-03-04T12:44:50-05:00",
    "taxable": true,
    "barcode": "1234_pink",
    "grams": 567,
    "image_id": 562641783,
    "weight": 1.25,
    "weight_unit": "lb",
    "inventory_item_id": 808950810,
    "inventory_quantity": 10,
    "old_inventory_quantity": 10,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "99.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

Add a metafield to an existing variant

PUT /admin/api/2019-07/variants/#{variant_id}.json

{
  "variant": {
    "id": 808950810,
    "metafields": [
      {
        "key": "new",
        "value": "newvalue",
        "value_type": "string",
        "namespace": "global"
      }
    ]
  }
}

View Response

HTTP/1.1 200 OK
{
  "variant": {
    "id": 808950810,
    "product_id": 632910392,
    "title": "Pink",
    "price": "199.00",
    "sku": "IPOD2008PINK",
    "position": 1,
    "inventory_policy": "continue",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Pink",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:35-05:00",
    "updated_at": "2020-03-04T12:44:51-05:00",
    "taxable": true,
    "barcode": "1234_pink",
    "grams": 567,
    "image_id": 562641783,
    "weight": 1.25,
    "weight_unit": "lb",
    "inventory_item_id": 808950810,
    "inventory_quantity": 10,
    "old_inventory_quantity": 10,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "199.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

Add an existing image to an existing variant

PUT /admin/api/2019-07/variants/#{variant_id}.json

{
  "variant": {
    "id": 808950810,
    "image_id": 562641783
  }
}

View Response

HTTP/1.1 200 OK
{
  "variant": {
    "id": 808950810,
    "product_id": 632910392,
    "title": "Pink",
    "price": "199.00",
    "sku": "IPOD2008PINK",
    "position": 1,
    "inventory_policy": "continue",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Pink",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:35-05:00",
    "updated_at": "2020-03-04T12:44:52-05:00",
    "taxable": true,
    "barcode": "1234_pink",
    "grams": 567,
    "image_id": 562641783,
    "weight": 1.25,
    "weight_unit": "lb",
    "inventory_item_id": 808950810,
    "inventory_quantity": 10,
    "old_inventory_quantity": 10,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "199.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

DELETE /admin/api/2019-07/products/#{product_id}/variants/#{variant_id}.json

Delete a product variant

DELETE /admin/api/2019-07/products/#{product_id}/variants/#{variant_id}.json

View Response

HTTP/1.1 200 OK
{
}

Version 2019-10

Important

Apps can no longer set inventory using inventory_quantity or inventory_quantity_adjustment. For more information, see Updating inventory.

What you can do with Product Variant

The Shopify API lets you do the following with the Product Variant resource. More detailed versions of these general actions may be available:

GET /admin/api/2019-10/products/#{product_id}/variants.json Retrieves a list of product variants
GET /admin/api/2019-10/products/#{product_id}/variants/count.json Receive a count of all Product Variants
GET /admin/api/2019-10/variants/#{variant_id}.json Receive a single Product Variant
POST /admin/api/2019-10/products/#{product_id}/variants.json Create a new Product Variant
PUT /admin/api/2019-10/variants/#{variant_id}.json Modify an existing Product Variant
DELETE /admin/api/2019-10/products/#{product_id}/variants/#{variant_id}.json Remove an existing Product Variant

Product Variant properties

barcode	`"barcode": "1234_pink"` The barcode, UPC, or ISBN number for the product.
compare_at_price	`"compare_at_price": "299.00"` The original price of the item before an adjustment or a sale.
created_at	`"created_at": "2012-08-24T14:01:47-04:00"` The date and time (ISO 8601 format) when the product variant was created.
fulfillment_service	`"fulfillment_service": "manual"` The fulfillment service associated with the product variant. Valid values: `manual` or the handle of a fulfillment service.
grams	`"grams": 567` The weight of the product variant in grams.
id	`"id": 808950810` The unique numeric identifier for the product variant.
image_id	`"image_id": 434522` The unique numeric identifier for a product's image. The image must be associated to the same product as the variant.
inventory_item_id	`"inventory_item_id": 342916` The unique identifier for the inventory item, which is used in the Inventory API to query for inventory information.
inventory_management	`"inventory_management": "shopify"` The fulfillment service that tracks the number of items in stock for the product variant. If you track the inventory yourself using the admin, then set the value to "shopify". Valid values: `shopify` or the handle of a fulfillment service that has inventory management enabled. Must be the same fulfillment service referenced by the `fulfillment_service` property.
inventory_policy	`"inventory_policy": "continue"` Whether customers are allowed to place an order for the product variant when it's out of stock. Valid values: `deny`: Customers are not allowed to place orders for the product variant if it's out of stock. `continue`: Customers are allowed to place orders for the product variant if it's out of stock. Default value: `deny`.
inventory_quantity read-only	`"inventory_quantity": 10` An aggregate of inventory across all locations. To adjust inventory at a specific location, use the InventoryLevel resource.
old_inventory_quantity deprecated	`"old_inventory_quantity": 5` This property is deprecated. Use the InventoryLevel resource instead.
inventory_quantity_adjustment deprecated	`"inventory_quantity_adjustment": 5` This property is deprecated. Use the InventoryLevel resource instead.
option	`"option1": "Pink"` The custom properties that a shop owner uses to define product variants. You can define three options for a product: `option1`, `option2`, `option3`. Default value: `Default Title`.
presentment_prices	"presentment_prices": [ { "price": { "currency_code": "USD", "amount": "199.99" }, "compare_at_price": { "currency_code": "USD", "amount": "249.99" } }, { "price": { "currency_code": "EUR", "amount": "158.95" }, "compare_at_price": { "currency_code": "EUR", "amount": "198.95" } }, { "price": { "currency_code": "GBP", "amount": "143.00" }, "compare_at_price": { "currency_code": "GBP", "amount": "179.00" } }, { "price": { "currency_code": "JPY", "amount": "22400" }, "compare_at_price": { "currency_code": "JPY", "amount": "28000" } } ] A list of the variant's presentment prices and compare-at prices in each of the shop's enabled presentment currencies. Each price object has the following properties: `currency_code`: The three-letter code (ISO 4217 format) for one of the shop's enabled presentment currencies. `amount`: The variant's price or compare-at price in the presentment currency. Requires the header `'X-Shopify-Api-Features': 'include-presentment-prices'`.
position read-only	`"position": 1` The order of the product variant in the list of product variants. The first position in the list is `1`. The position of variants is indicated by the order in which they are listed.
price	`"price": "199.00"` The price of the product variant.
product_id	`"product_id": 632910392` The unique numeric identifier for the product.
requires_shipping deprecated	`"requires_shipping": true` Whether a customer needs to provide a shipping address when placing an order for the product variant.
sku	`"sku": "IPOD2008PINK"` A unique identifier for the product variant in the shop. Required in order to connect to a FulfillmentService.
taxable	`"taxable": true` Whether a tax is charged when the product variant is sold.
tax_code	`"tax_code": "DA040000"` This parameter applies only to the stores that have the Avalara AvaTax app installed. Specifies the Avalara tax code for the product variant.
title	`"title": "Pink"` The title of the product variant.
updated_at	`"updated_at": "2012-08-24T14:01:47-04:00"` The date and time when the product variant was last modified. Gets returned in ISO 8601 format.
weight	`"weight": 100` The weight of the product variant in the unit system specified with `weight_unit`.
weight_unit	`"weight_unit": "oz"` The unit of measurement that applies to the product variant's weight. If you don't specify a value for `weight_unit`, then the shop's default unit of measurement is applied. Valid values: `g`, `kg`, `oz`, and `lb`.

Endpoints

GET /admin/api/2019-10/products/#{product_id}/variants.json

Retrieves a list of product variants. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.

limit	Return up to this many results per page (default: `50`, maximum: `250`)
presentment_currencies	Return presentment prices in only certain currencies, specified by a comma-separated list of ISO 4217 currency codes.
since_id	Restrict results to after the specified ID
fields	A comma-separated list of fields to include in the response

Retrieve all variants for a product

GET /admin/api/2019-10/products/#{product_id}/variants.json

View Response

HTTP/1.1 200 OK
{
  "variants": [
    {
      "id": 39072856,
      "product_id": 632910392,
      "title": "Green",
      "price": "199.00",
      "sku": "IPOD2008GREEN",
      "position": 3,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Green",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_green",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 39072856,
      "inventory_quantity": 30,
      "old_inventory_quantity": 30,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 49148385,
      "product_id": 632910392,
      "title": "Red",
      "price": "199.00",
      "sku": "IPOD2008RED",
      "position": 2,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Red",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_red",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 49148385,
      "inventory_quantity": 20,
      "old_inventory_quantity": 20,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 457924702,
      "product_id": 632910392,
      "title": "Black",
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "position": 4,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Black",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_black",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 457924702,
      "inventory_quantity": 40,
      "old_inventory_quantity": 40,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 808950810,
      "product_id": 632910392,
      "title": "Pink",
      "price": "199.00",
      "sku": "IPOD2008PINK",
      "position": 1,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Pink",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_pink",
      "grams": 567,
      "image_id": 562641783,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 808950810,
      "inventory_quantity": 10,
      "old_inventory_quantity": 10,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    }
  ]
}

Retrieve all variants for a product after a specified ID

GET /admin/api/2019-10/products/#{product_id}/variants.json?since_id=49148385

View Response

HTTP/1.1 200 OK
{
  "variants": [
    {
      "id": 457924702,
      "product_id": 632910392,
      "title": "Black",
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "position": 4,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Black",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_black",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 457924702,
      "inventory_quantity": 40,
      "old_inventory_quantity": 40,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 808950810,
      "product_id": 632910392,
      "title": "Pink",
      "price": "199.00",
      "sku": "IPOD2008PINK",
      "position": 1,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Pink",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_pink",
      "grams": 567,
      "image_id": 562641783,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 808950810,
      "inventory_quantity": 10,
      "old_inventory_quantity": 10,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    }
  ]
}

Retrieve all variants for a product with prices in specified presentment currencies

GET /admin/api/2019-10/products/#{product_id}/variants.json?presentment_currencies=USD,CAD

View Response

HTTP/1.1 200 OK
{
  "variants": [
    {
      "id": 39072856,
      "product_id": 632910392,
      "title": "Green",
      "price": "199.00",
      "sku": "IPOD2008GREEN",
      "position": 3,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Green",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_green",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 39072856,
      "inventory_quantity": 30,
      "old_inventory_quantity": 30,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": {
            "currency_code": "USD",
            "amount": "249.00"
          }
        },
        {
          "price": {
            "currency_code": "CAD",
            "amount": "248.75"
          },
          "compare_at_price": {
            "currency_code": "CAD",
            "amount": "311.25"
          }
        }
      ]
    },
    {
      "id": 49148385,
      "product_id": 632910392,
      "title": "Red",
      "price": "199.00",
      "sku": "IPOD2008RED",
      "position": 2,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Red",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_red",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 49148385,
      "inventory_quantity": 20,
      "old_inventory_quantity": 20,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": {
            "currency_code": "USD",
            "amount": "249.00"
          }
        },
        {
          "price": {
            "currency_code": "CAD",
            "amount": "248.75"
          },
          "compare_at_price": {
            "currency_code": "CAD",
            "amount": "311.25"
          }
        }
      ]
    },
    {
      "id": 457924702,
      "product_id": 632910392,
      "title": "Black",
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "position": 4,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Black",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_black",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 457924702,
      "inventory_quantity": 40,
      "old_inventory_quantity": 40,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": {
            "currency_code": "USD",
            "amount": "249.00"
          }
        },
        {
          "price": {
            "currency_code": "CAD",
            "amount": "248.75"
          },
          "compare_at_price": {
            "currency_code": "CAD",
            "amount": "311.25"
          }
        }
      ]
    },
    {
      "id": 808950810,
      "product_id": 632910392,
      "title": "Pink",
      "price": "199.00",
      "sku": "IPOD2008PINK",
      "position": 1,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Pink",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_pink",
      "grams": 567,
      "image_id": 562641783,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 808950810,
      "inventory_quantity": 10,
      "old_inventory_quantity": 10,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": {
            "currency_code": "USD",
            "amount": "249.00"
          }
        },
        {
          "price": {
            "currency_code": "CAD",
            "amount": "248.75"
          },
          "compare_at_price": {
            "currency_code": "CAD",
            "amount": "311.25"
          }
        }
      ]
    }
  ]
}

GET /admin/api/2019-10/products/#{product_id}/variants/count.json

Retrieves a count of product variants

Retrieve a count all variants for a product

GET /admin/api/2019-10/products/#{product_id}/variants/count.json

View Response

HTTP/1.1 200 OK
{
  "count": 4
}

GET /admin/api/2019-10/variants/#{variant_id}.json

Retrieves a single product variant by ID

fields

A comma-separated list of fields to include in the response

Retrieve a product variant by ID

GET /admin/api/2019-10/variants/#{variant_id}.json

View Response

HTTP/1.1 200 OK
{
  "variant": {
    "id": 808950810,
    "product_id": 632910392,
    "title": "Pink",
    "price": "199.00",
    "sku": "IPOD2008PINK",
    "position": 1,
    "inventory_policy": "continue",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Pink",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:35-05:00",
    "updated_at": "2020-03-04T12:44:35-05:00",
    "taxable": true,
    "barcode": "1234_pink",
    "grams": 567,
    "image_id": 562641783,
    "weight": 1.25,
    "weight_unit": "lb",
    "inventory_item_id": 808950810,
    "inventory_quantity": 10,
    "old_inventory_quantity": 10,
    "tax_code": "DA040000",
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "199.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

POST /admin/api/2019-10/products/#{product_id}/variants.json

Creates a new product variant

Create a new product variant

POST /admin/api/2019-10/products/#{product_id}/variants.json

{
  "variant": {
    "option1": "Yellow",
    "price": "1.00"
  }
}

View Response

HTTP/1.1 201 Created
{
  "variant": {
    "id": 1070325047,
    "product_id": 632910392,
    "title": "Yellow",
    "price": "1.00",
    "sku": "",
    "position": 5,
    "inventory_policy": "deny",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Yellow",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:48-05:00",
    "updated_at": "2020-03-04T12:44:48-05:00",
    "taxable": true,
    "barcode": null,
    "grams": 0,
    "image_id": null,
    "weight": 0.0,
    "weight_unit": "lb",
    "inventory_item_id": 1070325051,
    "inventory_quantity": 0,
    "old_inventory_quantity": 0,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325047",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "1.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

Create a new product variant with a metafield

POST /admin/api/2019-10/products/#{product_id}/variants.json

{
  "variant": {
    "option1": "Blue",
    "metafields": [
      {
        "key": "new",
        "value": "newvalue",
        "value_type": "string",
        "namespace": "global"
      }
    ]
  }
}

View Response

HTTP/1.1 201 Created
{
  "variant": {
    "id": 1070325048,
    "product_id": 632910392,
    "title": "Blue",
    "price": "0.00",
    "sku": "",
    "position": 5,
    "inventory_policy": "deny",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Blue",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:49-05:00",
    "updated_at": "2020-03-04T12:44:49-05:00",
    "taxable": true,
    "barcode": null,
    "grams": 0,
    "image_id": null,
    "weight": 0.0,
    "weight_unit": "lb",
    "inventory_item_id": 1070325052,
    "inventory_quantity": 0,
    "old_inventory_quantity": 0,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325048",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "0.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

Create a new product variant with an image

POST /admin/api/2019-10/products/#{product_id}/variants.json

{
  "variant": {
    "image_id": 850703190,
    "option1": "Purple"
  }
}

View Response

HTTP/1.1 201 Created
{
  "variant": {
    "id": 1070325049,
    "product_id": 632910392,
    "title": "Purple",
    "price": "0.00",
    "sku": "",
    "position": 5,
    "inventory_policy": "deny",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Purple",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:50-05:00",
    "updated_at": "2020-03-04T12:44:50-05:00",
    "taxable": true,
    "barcode": null,
    "grams": 0,
    "image_id": 850703190,
    "weight": 0.0,
    "weight_unit": "lb",
    "inventory_item_id": 1070325053,
    "inventory_quantity": 0,
    "old_inventory_quantity": 0,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325049",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "0.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

PUT /admin/api/2019-10/variants/#{variant_id}.json

Updates an existing product variant

Update the title and price of an existing variant

PUT /admin/api/2019-10/variants/#{variant_id}.json

{
  "variant": {
    "id": 808950810,
    "option1": "Not Pink",
    "price": "99.00"
  }
}

View Response

HTTP/1.1 200 OK
{
  "variant": {
    "id": 808950810,
    "product_id": 632910392,
    "title": "Not Pink",
    "price": "99.00",
    "sku": "IPOD2008PINK",
    "position": 1,
    "inventory_policy": "continue",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Not Pink",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:35-05:00",
    "updated_at": "2020-03-04T12:44:50-05:00",
    "taxable": true,
    "barcode": "1234_pink",
    "grams": 567,
    "image_id": 562641783,
    "weight": 1.25,
    "weight_unit": "lb",
    "inventory_item_id": 808950810,
    "inventory_quantity": 10,
    "old_inventory_quantity": 10,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "99.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

Add a metafield to an existing variant

PUT /admin/api/2019-10/variants/#{variant_id}.json

{
  "variant": {
    "id": 808950810,
    "metafields": [
      {
        "key": "new",
        "value": "newvalue",
        "value_type": "string",
        "namespace": "global"
      }
    ]
  }
}

View Response

HTTP/1.1 200 OK
{
  "variant": {
    "id": 808950810,
    "product_id": 632910392,
    "title": "Pink",
    "price": "199.00",
    "sku": "IPOD2008PINK",
    "position": 1,
    "inventory_policy": "continue",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Pink",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:35-05:00",
    "updated_at": "2020-03-04T12:44:51-05:00",
    "taxable": true,
    "barcode": "1234_pink",
    "grams": 567,
    "image_id": 562641783,
    "weight": 1.25,
    "weight_unit": "lb",
    "inventory_item_id": 808950810,
    "inventory_quantity": 10,
    "old_inventory_quantity": 10,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "199.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

Add an existing image to an existing variant

PUT /admin/api/2019-10/variants/#{variant_id}.json

{
  "variant": {
    "id": 808950810,
    "image_id": 562641783
  }
}

View Response

HTTP/1.1 200 OK
{
  "variant": {
    "id": 808950810,
    "product_id": 632910392,
    "title": "Pink",
    "price": "199.00",
    "sku": "IPOD2008PINK",
    "position": 1,
    "inventory_policy": "continue",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Pink",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:35-05:00",
    "updated_at": "2020-03-04T12:44:52-05:00",
    "taxable": true,
    "barcode": "1234_pink",
    "grams": 567,
    "image_id": 562641783,
    "weight": 1.25,
    "weight_unit": "lb",
    "inventory_item_id": 808950810,
    "inventory_quantity": 10,
    "old_inventory_quantity": 10,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "199.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

DELETE /admin/api/2019-10/products/#{product_id}/variants/#{variant_id}.json

Delete a product variant

DELETE /admin/api/2019-10/products/#{product_id}/variants/#{variant_id}.json

View Response

HTTP/1.1 200 OK
{
}

Version 2020-01 (Latest)

Important

Apps can no longer set inventory using inventory_quantity or inventory_quantity_adjustment. For more information, see Updating inventory.

What you can do with Product Variant

The Shopify API lets you do the following with the Product Variant resource. More detailed versions of these general actions may be available:

GET /admin/api/2020-01/products/#{product_id}/variants.json Retrieves a list of product variants
GET /admin/api/2020-01/products/#{product_id}/variants/count.json Receive a count of all Product Variants
GET /admin/api/2020-01/variants/#{variant_id}.json Receive a single Product Variant
POST /admin/api/2020-01/products/#{product_id}/variants.json Create a new Product Variant
PUT /admin/api/2020-01/variants/#{variant_id}.json Modify an existing Product Variant
DELETE /admin/api/2020-01/products/#{product_id}/variants/#{variant_id}.json Remove an existing Product Variant

Product Variant properties

barcode	`"barcode": "1234_pink"` The barcode, UPC, or ISBN number for the product.
compare_at_price	`"compare_at_price": "299.00"` The original price of the item before an adjustment or a sale.
created_at	`"created_at": "2012-08-24T14:01:47-04:00"` The date and time (ISO 8601 format) when the product variant was created.
fulfillment_service	`"fulfillment_service": "manual"` The fulfillment service associated with the product variant. Valid values: `manual` or the handle of a fulfillment service.
grams	`"grams": 567` The weight of the product variant in grams.
id	`"id": 808950810` The unique numeric identifier for the product variant.
image_id	`"image_id": 434522` The unique numeric identifier for a product's image. The image must be associated to the same product as the variant.
inventory_item_id	`"inventory_item_id": 342916` The unique identifier for the inventory item, which is used in the Inventory API to query for inventory information.
inventory_management	`"inventory_management": "shopify"` The fulfillment service that tracks the number of items in stock for the product variant. If you track the inventory yourself using the admin, then set the value to "shopify". Valid values: `shopify` or the handle of a fulfillment service that has inventory management enabled. Must be the same fulfillment service referenced by the `fulfillment_service` property.
inventory_policy	`"inventory_policy": "continue"` Whether customers are allowed to place an order for the product variant when it's out of stock. Valid values: `deny`: Customers are not allowed to place orders for the product variant if it's out of stock. `continue`: Customers are allowed to place orders for the product variant if it's out of stock. Default value: `deny`.
inventory_quantity read-only	`"inventory_quantity": 10` An aggregate of inventory across all locations. To adjust inventory at a specific location, use the InventoryLevel resource.
old_inventory_quantity deprecated	`"old_inventory_quantity": 5` This property is deprecated. Use the InventoryLevel resource instead.
inventory_quantity_adjustment deprecated	`"inventory_quantity_adjustment": 5` This property is deprecated. Use the InventoryLevel resource instead.
option	`"option1": "Pink"` The custom properties that a shop owner uses to define product variants. You can define three options for a product: `option1`, `option2`, `option3`. Default value: `Default Title`.
presentment_prices	"presentment_prices": [ { "price": { "currency_code": "USD", "amount": "199.99" }, "compare_at_price": { "currency_code": "USD", "amount": "249.99" } }, { "price": { "currency_code": "EUR", "amount": "158.95" }, "compare_at_price": { "currency_code": "EUR", "amount": "198.95" } }, { "price": { "currency_code": "GBP", "amount": "143.00" }, "compare_at_price": { "currency_code": "GBP", "amount": "179.00" } }, { "price": { "currency_code": "JPY", "amount": "22400" }, "compare_at_price": { "currency_code": "JPY", "amount": "28000" } } ] A list of the variant's presentment prices and compare-at prices in each of the shop's enabled presentment currencies. Each price object has the following properties: `currency_code`: The three-letter code (ISO 4217 format) for one of the shop's enabled presentment currencies. `amount`: The variant's price or compare-at price in the presentment currency. Requires the header `'X-Shopify-Api-Features': 'include-presentment-prices'`.
position read-only	`"position": 1` The order of the product variant in the list of product variants. The first position in the list is `1`. The position of variants is indicated by the order in which they are listed.
price	`"price": "199.00"` The price of the product variant.
product_id	`"product_id": 632910392` The unique numeric identifier for the product.
requires_shipping deprecated	`"requires_shipping": true` This property is deprecated. Use the `requires_shipping` property on the InventoryItem resource instead.
sku	`"sku": "IPOD2008PINK"` A unique identifier for the product variant in the shop. Required in order to connect to a FulfillmentService.
taxable	`"taxable": true` Whether a tax is charged when the product variant is sold.
tax_code	`"tax_code": "DA040000"` This parameter applies only to the stores that have the Avalara AvaTax app installed. Specifies the Avalara tax code for the product variant.
title	`"title": "Pink"` The title of the product variant.
updated_at	`"updated_at": "2012-08-24T14:01:47-04:00"` The date and time when the product variant was last modified. Gets returned in ISO 8601 format.
weight	`"weight": 100` The weight of the product variant in the unit system specified with `weight_unit`.
weight_unit	`"weight_unit": "oz"` The unit of measurement that applies to the product variant's weight. If you don't specify a value for `weight_unit`, then the shop's default unit of measurement is applied. Valid values: `g`, `kg`, `oz`, and `lb`.

Endpoints

GET /admin/api/2020-01/products/#{product_id}/variants.json

limit	Return up to this many results per page (default: `50`, maximum: `250`)
presentment_currencies	Return presentment prices in only certain currencies, specified by a comma-separated list of ISO 4217 currency codes.
since_id	Restrict results to after the specified ID
fields	A comma-separated list of fields to include in the response

Retrieve all variants for a product

GET /admin/api/2020-01/products/#{product_id}/variants.json

View Response

HTTP/1.1 200 OK
{
  "variants": [
    {
      "id": 39072856,
      "product_id": 632910392,
      "title": "Green",
      "price": "199.00",
      "sku": "IPOD2008GREEN",
      "position": 3,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Green",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_green",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 39072856,
      "inventory_quantity": 30,
      "old_inventory_quantity": 30,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 49148385,
      "product_id": 632910392,
      "title": "Red",
      "price": "199.00",
      "sku": "IPOD2008RED",
      "position": 2,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Red",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_red",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 49148385,
      "inventory_quantity": 20,
      "old_inventory_quantity": 20,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 457924702,
      "product_id": 632910392,
      "title": "Black",
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "position": 4,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Black",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_black",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 457924702,
      "inventory_quantity": 40,
      "old_inventory_quantity": 40,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 808950810,
      "product_id": 632910392,
      "title": "Pink",
      "price": "199.00",
      "sku": "IPOD2008PINK",
      "position": 1,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Pink",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_pink",
      "grams": 567,
      "image_id": 562641783,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 808950810,
      "inventory_quantity": 10,
      "old_inventory_quantity": 10,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    }
  ]
}

Retrieve all variants for a product after a specified ID

GET /admin/api/2020-01/products/#{product_id}/variants.json?since_id=49148385

View Response

HTTP/1.1 200 OK
{
  "variants": [
    {
      "id": 457924702,
      "product_id": 632910392,
      "title": "Black",
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "position": 4,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Black",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_black",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 457924702,
      "inventory_quantity": 40,
      "old_inventory_quantity": 40,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 808950810,
      "product_id": 632910392,
      "title": "Pink",
      "price": "199.00",
      "sku": "IPOD2008PINK",
      "position": 1,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Pink",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_pink",
      "grams": 567,
      "image_id": 562641783,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 808950810,
      "inventory_quantity": 10,
      "old_inventory_quantity": 10,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    }
  ]
}

Retrieve all variants for a product with prices in specified presentment currencies

GET /admin/api/2020-01/products/#{product_id}/variants.json?presentment_currencies=USD,CAD

View Response

HTTP/1.1 200 OK
{
  "variants": [
    {
      "id": 39072856,
      "product_id": 632910392,
      "title": "Green",
      "price": "199.00",
      "sku": "IPOD2008GREEN",
      "position": 3,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Green",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_green",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 39072856,
      "inventory_quantity": 30,
      "old_inventory_quantity": 30,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": {
            "currency_code": "USD",
            "amount": "249.00"
          }
        },
        {
          "price": {
            "currency_code": "CAD",
            "amount": "248.75"
          },
          "compare_at_price": {
            "currency_code": "CAD",
            "amount": "311.25"
          }
        }
      ]
    },
    {
      "id": 49148385,
      "product_id": 632910392,
      "title": "Red",
      "price": "199.00",
      "sku": "IPOD2008RED",
      "position": 2,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Red",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_red",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 49148385,
      "inventory_quantity": 20,
      "old_inventory_quantity": 20,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": {
            "currency_code": "USD",
            "amount": "249.00"
          }
        },
        {
          "price": {
            "currency_code": "CAD",
            "amount": "248.75"
          },
          "compare_at_price": {
            "currency_code": "CAD",
            "amount": "311.25"
          }
        }
      ]
    },
    {
      "id": 457924702,
      "product_id": 632910392,
      "title": "Black",
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "position": 4,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Black",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_black",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 457924702,
      "inventory_quantity": 40,
      "old_inventory_quantity": 40,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": {
            "currency_code": "USD",
            "amount": "249.00"
          }
        },
        {
          "price": {
            "currency_code": "CAD",
            "amount": "248.75"
          },
          "compare_at_price": {
            "currency_code": "CAD",
            "amount": "311.25"
          }
        }
      ]
    },
    {
      "id": 808950810,
      "product_id": 632910392,
      "title": "Pink",
      "price": "199.00",
      "sku": "IPOD2008PINK",
      "position": 1,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Pink",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_pink",
      "grams": 567,
      "image_id": 562641783,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 808950810,
      "inventory_quantity": 10,
      "old_inventory_quantity": 10,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": {
            "currency_code": "USD",
            "amount": "249.00"
          }
        },
        {
          "price": {
            "currency_code": "CAD",
            "amount": "248.75"
          },
          "compare_at_price": {
            "currency_code": "CAD",
            "amount": "311.25"
          }
        }
      ]
    }
  ]
}

GET /admin/api/2020-01/products/#{product_id}/variants/count.json

Retrieves a count of product variants

Retrieve a count all variants for a product

GET /admin/api/2020-01/products/#{product_id}/variants/count.json

View Response

HTTP/1.1 200 OK
{
  "count": 4
}

GET /admin/api/2020-01/variants/#{variant_id}.json

Retrieves a single product variant by ID

fields

A comma-separated list of fields to include in the response

Retrieve a product variant by ID

GET /admin/api/2020-01/variants/#{variant_id}.json

View Response

HTTP/1.1 200 OK
{
  "variant": {
    "id": 808950810,
    "product_id": 632910392,
    "title": "Pink",
    "price": "199.00",
    "sku": "IPOD2008PINK",
    "position": 1,
    "inventory_policy": "continue",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Pink",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:35-05:00",
    "updated_at": "2020-03-04T12:44:35-05:00",
    "taxable": true,
    "barcode": "1234_pink",
    "grams": 567,
    "image_id": 562641783,
    "weight": 1.25,
    "weight_unit": "lb",
    "inventory_item_id": 808950810,
    "inventory_quantity": 10,
    "old_inventory_quantity": 10,
    "tax_code": "DA040000",
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "199.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

POST /admin/api/2020-01/products/#{product_id}/variants.json

Creates a new product variant

Create a new product variant

POST /admin/api/2020-01/products/#{product_id}/variants.json

{
  "variant": {
    "option1": "Yellow",
    "price": "1.00"
  }
}

View Response

HTTP/1.1 201 Created
{
  "variant": {
    "id": 1070325047,
    "product_id": 632910392,
    "title": "Yellow",
    "price": "1.00",
    "sku": "",
    "position": 5,
    "inventory_policy": "deny",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Yellow",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:48-05:00",
    "updated_at": "2020-03-04T12:44:48-05:00",
    "taxable": true,
    "barcode": null,
    "grams": 0,
    "image_id": null,
    "weight": 0.0,
    "weight_unit": "lb",
    "inventory_item_id": 1070325051,
    "inventory_quantity": 0,
    "old_inventory_quantity": 0,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325047",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "1.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

Create a new product variant with a metafield

POST /admin/api/2020-01/products/#{product_id}/variants.json

{
  "variant": {
    "option1": "Blue",
    "metafields": [
      {
        "key": "new",
        "value": "newvalue",
        "value_type": "string",
        "namespace": "global"
      }
    ]
  }
}

View Response

HTTP/1.1 201 Created
{
  "variant": {
    "id": 1070325048,
    "product_id": 632910392,
    "title": "Blue",
    "price": "0.00",
    "sku": "",
    "position": 5,
    "inventory_policy": "deny",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Blue",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:49-05:00",
    "updated_at": "2020-03-04T12:44:49-05:00",
    "taxable": true,
    "barcode": null,
    "grams": 0,
    "image_id": null,
    "weight": 0.0,
    "weight_unit": "lb",
    "inventory_item_id": 1070325052,
    "inventory_quantity": 0,
    "old_inventory_quantity": 0,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325048",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "0.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

Create a new product variant with an image

POST /admin/api/2020-01/products/#{product_id}/variants.json

{
  "variant": {
    "image_id": 850703190,
    "option1": "Purple"
  }
}

View Response

HTTP/1.1 201 Created
{
  "variant": {
    "id": 1070325049,
    "product_id": 632910392,
    "title": "Purple",
    "price": "0.00",
    "sku": "",
    "position": 5,
    "inventory_policy": "deny",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Purple",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:50-05:00",
    "updated_at": "2020-03-04T12:44:50-05:00",
    "taxable": true,
    "barcode": null,
    "grams": 0,
    "image_id": 850703190,
    "weight": 0.0,
    "weight_unit": "lb",
    "inventory_item_id": 1070325053,
    "inventory_quantity": 0,
    "old_inventory_quantity": 0,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325049",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "0.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

PUT /admin/api/2020-01/variants/#{variant_id}.json

Updates an existing product variant

Update the title and price of an existing variant

PUT /admin/api/2020-01/variants/#{variant_id}.json

{
  "variant": {
    "id": 808950810,
    "option1": "Not Pink",
    "price": "99.00"
  }
}

View Response

HTTP/1.1 200 OK
{
  "variant": {
    "id": 808950810,
    "product_id": 632910392,
    "title": "Not Pink",
    "price": "99.00",
    "sku": "IPOD2008PINK",
    "position": 1,
    "inventory_policy": "continue",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Not Pink",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:35-05:00",
    "updated_at": "2020-03-04T12:44:50-05:00",
    "taxable": true,
    "barcode": "1234_pink",
    "grams": 567,
    "image_id": 562641783,
    "weight": 1.25,
    "weight_unit": "lb",
    "inventory_item_id": 808950810,
    "inventory_quantity": 10,
    "old_inventory_quantity": 10,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "99.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

Add a metafield to an existing variant

PUT /admin/api/2020-01/variants/#{variant_id}.json

{
  "variant": {
    "id": 808950810,
    "metafields": [
      {
        "key": "new",
        "value": "newvalue",
        "value_type": "string",
        "namespace": "global"
      }
    ]
  }
}

View Response

HTTP/1.1 200 OK
{
  "variant": {
    "id": 808950810,
    "product_id": 632910392,
    "title": "Pink",
    "price": "199.00",
    "sku": "IPOD2008PINK",
    "position": 1,
    "inventory_policy": "continue",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Pink",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:35-05:00",
    "updated_at": "2020-03-04T12:44:51-05:00",
    "taxable": true,
    "barcode": "1234_pink",
    "grams": 567,
    "image_id": 562641783,
    "weight": 1.25,
    "weight_unit": "lb",
    "inventory_item_id": 808950810,
    "inventory_quantity": 10,
    "old_inventory_quantity": 10,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "199.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

Add an existing image to an existing variant

PUT /admin/api/2020-01/variants/#{variant_id}.json

{
  "variant": {
    "id": 808950810,
    "image_id": 562641783
  }
}

View Response

HTTP/1.1 200 OK
{
  "variant": {
    "id": 808950810,
    "product_id": 632910392,
    "title": "Pink",
    "price": "199.00",
    "sku": "IPOD2008PINK",
    "position": 1,
    "inventory_policy": "continue",
    "compare_at_price": null,
    "fulfillment_service": "manual",
    "inventory_management": "shopify",
    "option1": "Pink",
    "option2": null,
    "option3": null,
    "created_at": "2020-03-04T12:44:35-05:00",
    "updated_at": "2020-03-04T12:44:52-05:00",
    "taxable": true,
    "barcode": "1234_pink",
    "grams": 567,
    "image_id": 562641783,
    "weight": 1.25,
    "weight_unit": "lb",
    "inventory_item_id": 808950810,
    "inventory_quantity": 10,
    "old_inventory_quantity": 10,
    "requires_shipping": true,
    "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "199.00"
        },
        "compare_at_price": null
      }
    ]
  }
}

DELETE /admin/api/2020-01/products/#{product_id}/variants/#{variant_id}.json

Delete a product variant

DELETE /admin/api/2020-01/products/#{product_id}/variants/#{variant_id}.json

View Response

HTTP/1.1 200 OK
{
}

Version 2020-04 (Release candidate)

Important

Apps can no longer set inventory using inventory_quantity or inventory_quantity_adjustment. For more information, see Updating inventory.

What you can do with Product Variant

The Shopify API lets you do the following with the Product Variant resource. More detailed versions of these general actions may be available:

GET /admin/api/2020-04/products/#{product_id}/variants.json Retrieves a list of product variants
GET /admin/api/2020-04/products/#{product_id}/variants/count.json Receive a count of all Product Variants
GET /admin/api/2020-04/variants/#{variant_id}.json Receive a single Product Variant
POST /admin/api/2020-04/products/#{product_id}/variants.json Create a new Product Variant
PUT /admin/api/2020-04/variants/#{variant_id}.json Modify an existing Product Variant
DELETE /admin/api/2020-04/products/#{product_id}/variants/#{variant_id}.json Remove an existing Product Variant

Product Variant properties

barcode	`"barcode": "1234_pink"` The barcode, UPC, or ISBN number for the product.
compare_at_price	`"compare_at_price": "299.00"` The original price of the item before an adjustment or a sale.
created_at	`"created_at": "2012-08-24T14:01:47-04:00"` The date and time (ISO 8601 format) when the product variant was created.
fulfillment_service	`"fulfillment_service": "manual"` The fulfillment service associated with the product variant. Valid values: `manual` or the handle of a fulfillment service.
grams	`"grams": 567` The weight of the product variant in grams.
id	`"id": 808950810` The unique numeric identifier for the product variant.
image_id	`"image_id": 434522` The unique numeric identifier for a product's image. The image must be associated to the same product as the variant.
inventory_item_id	`"inventory_item_id": 342916` The unique identifier for the inventory item, which is used in the Inventory API to query for inventory information.
inventory_management	`"inventory_management": "shopify"` The fulfillment service that tracks the number of items in stock for the product variant. If you track the inventory yourself using the admin, then set the value to "shopify". Valid values: `shopify` or the handle of a fulfillment service that has inventory management enabled. Must be the same fulfillment service referenced by the `fulfillment_service` property.
inventory_policy	`"inventory_policy": "continue"` Whether customers are allowed to place an order for the product variant when it's out of stock. Valid values: `deny`: Customers are not allowed to place orders for the product variant if it's out of stock. `continue`: Customers are allowed to place orders for the product variant if it's out of stock. Default value: `deny`.
inventory_quantity read-only	`"inventory_quantity": 10` An aggregate of inventory across all locations. To adjust inventory at a specific location, use the InventoryLevel resource.
old_inventory_quantity deprecated	`"old_inventory_quantity": 5` This property is deprecated. Use the InventoryLevel resource instead.
inventory_quantity_adjustment deprecated	`"inventory_quantity_adjustment": 5` This property is deprecated. Use the InventoryLevel resource instead.
option	`"option1": "Pink"` The custom properties that a shop owner uses to define product variants. You can define three options for a product: `option1`, `option2`, `option3`. Default value: `Default Title`.
presentment_prices	"presentment_prices": [ { "price": { "currency_code": "USD", "amount": "199.99" }, "compare_at_price": { "currency_code": "USD", "amount": "249.99" } }, { "price": { "currency_code": "EUR", "amount": "158.95" }, "compare_at_price": { "currency_code": "EUR", "amount": "198.95" } }, { "price": { "currency_code": "GBP", "amount": "143.00" }, "compare_at_price": { "currency_code": "GBP", "amount": "179.00" } }, { "price": { "currency_code": "JPY", "amount": "22400" }, "compare_at_price": { "currency_code": "JPY", "amount": "28000" } } ] A list of the variant's presentment prices and compare-at prices in each of the shop's enabled presentment currencies. Each price object has the following properties: `currency_code`: The three-letter code (ISO 4217 format) for one of the shop's enabled presentment currencies. `amount`: The variant's price or compare-at price in the presentment currency. Requires the header `'X-Shopify-Api-Features': 'include-presentment-prices'`.
position read-only	`"position": 1` The order of the product variant in the list of product variants. The first position in the list is `1`. The position of variants is indicated by the order in which they are listed.
price	`"price": "199.00"` The price of the product variant.
product_id	`"product_id": 632910392` The unique numeric identifier for the product.
requires_shipping deprecated	`"requires_shipping": true` This property is deprecated. Use the `requires_shipping` property on the InventoryItem resource instead.
sku	`"sku": "IPOD2008PINK"` A unique identifier for the product variant in the shop. Required in order to connect to a FulfillmentService.
taxable	`"taxable": true` Whether a tax is charged when the product variant is sold.
tax_code	`"tax_code": "DA040000"` This parameter applies only to the stores that have the Avalara AvaTax app installed. Specifies the Avalara tax code for the product variant.
title	`"title": "Pink"` The title of the product variant.
updated_at	`"updated_at": "2012-08-24T14:01:47-04:00"` The date and time when the product variant was last modified. Gets returned in ISO 8601 format.
weight	`"weight": 100` The weight of the product variant in the unit system specified with `weight_unit`.
weight_unit	`"weight_unit": "oz"` The unit of measurement that applies to the product variant's weight. If you don't specify a value for `weight_unit`, then the shop's default unit of measurement is applied. Valid values: `g`, `kg`, `oz`, and `lb`.

Endpoints

GET /admin/api/2020-04/products/#{product_id}/variants.json

limit	Return up to this many results per page (default: `50`, maximum: `250`)
presentment_currencies	Return presentment prices in only certain currencies, specified by a comma-separated list of ISO 4217 currency codes.
since_id	Restrict results to after the specified ID
fields	A comma-separated list of fields to include in the response

Retrieve all variants for a product

GET /admin/api/2020-04/products/#{product_id}/variants.json

View Response

HTTP/1.1 200 OK
{
  "variants": [
    {
      "id": 39072856,
      "product_id": 632910392,
      "title": "Green",
      "price": "199.00",
      "sku": "IPOD2008GREEN",
      "position": 3,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Green",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_green",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 39072856,
      "inventory_quantity": 30,
      "old_inventory_quantity": 30,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 49148385,
      "product_id": 632910392,
      "title": "Red",
      "price": "199.00",
      "sku": "IPOD2008RED",
      "position": 2,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Red",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_red",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 49148385,
      "inventory_quantity": 20,
      "old_inventory_quantity": 20,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 457924702,
      "product_id": 632910392,
      "title": "Black",
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "position": 4,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Black",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_black",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 457924702,
      "inventory_quantity": 40,
      "old_inventory_quantity": 40,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 808950810,
      "product_id": 632910392,
      "title": "Pink",
      "price": "199.00",
      "sku": "IPOD2008PINK",
      "position": 1,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Pink",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_pink",
      "grams": 567,
      "image_id": 562641783,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 808950810,
      "inventory_quantity": 10,
      "old_inventory_quantity": 10,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    }
  ]
}

Retrieve all variants for a product after a specified ID

GET /admin/api/2020-04/products/#{product_id}/variants.json?since_id=49148385

View Response

HTTP/1.1 200 OK
{
  "variants": [
    {
      "id": 457924702,
      "product_id": 632910392,
      "title": "Black",
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "position": 4,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Black",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_black",
      "grams": 567,
      "image_id": null,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 457924702,
      "inventory_quantity": 40,
      "old_inventory_quantity": 40,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    },
    {
      "id": 808950810,
      "product_id": 632910392,
      "title": "Pink",
      "price": "199.00",
      "sku": "IPOD2008PINK",
      "position": 1,
      "inventory_policy": "continue",
      "compare_at_price": null,
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Pink",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",
      "updated_at": "2020-03-04T12:44:35-05:00",
      "taxable": true,
      "barcode": "1234_pink",
      "grams": 567,
      "image_id": 562641783,
      "weight": 1.25,
      "weight_unit": "lb",
      "inventory_item_id": 808950810,
      "inventory_quantity": 10,
      "old_inventory_quantity": 10,
      "requires_shipping": true,
      "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810",
      "presentment_prices": [
        {
          "price": {
            "currency_code": "USD",
            "amount": "199.00"
          },
          "compare_at_price": null
        }
      ]
    }
  ]
}

Retrieve all variants for a product with prices in specified presentment currencies

GET /admin/api/2020-04/products/#{product_id}/variants.json?presentment_currencies=USD,CAD

View Response

HTTP/1.1 200 OK
{
  "variants": [
    {
      "id": 39072856,
      "product_id": 632910392,
      "title": "Green",
      "price": "199.00",
      "sku": "IPOD2008GREEN",
      "position": 3,
      "inventory_policy": "continue",
      "compare_at_price": "249.00",
      "fulfillment_service": "manual",
      "inventory_management": "shopify",
      "option1": "Green",
      "option2": null,
      "option3": null,
      "created_at": "2020-03-04T12:44:35-05:00",