Update a variant

Requires write_products access scope.
For more info, refer to:
access permission.
PUT https://{handle}.myshopline.com/admin/openapi/v20261201/products/variants/:variant_id.json
handle : The store's unique identifier, which is the prefix of the store's domain name. For example, if a store's domain name is open001.myshopline.com , the store handle is open001 .
Update the information for a product variant.
Path Parameters
  • variant_id string required
    The unique identifier for a variant.
    Maximum length: 64
    Example: 18057039439794751459380282
Request Headers
  • Content-Type string required
    The field must be set to the fixed value application/json; charset=utf-8.
  • Authorization string required
    The access token for the API resource. Refer to App authorization to obtain the access token, and then pass the obtained token in the Bearer format.
    Example:
    Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzU2ZjI1NWE2NjdlZTcwNTk1MzM0ZjVjYzk4NzU5MzBmN2E3NGZjMSIsImV4cCI6MTg3OTQ4MjA3NiwiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjIwMDAyMzQ4ODAiLCJzdG9yZUlkIjoiMTY3MjM2OTcyOTYwNiIsInRpbWVzdGFtcCI6MTc4NDc4NzY3NjY2MSwidmVyc2lvbiI6IlYyIn0.3ZzbGAH4cLU1QR2VPEvMOQInUDvus-C4amkINSQIPuNVlXsFKj0sAt1c0KnUy9MWUOFV9cHlkf7J90r2y1FzpA
Request Body
  • variantobject
    Variant information.
  • option2 string
    Information of the second option of the variant.
    Maximum length: 255
    Example: xl
  • barcode string
    The barcode of the variant.
    Maximum length: 255
    Example: T0000001
  • option1 string
    Information of the first option of the variant.
    Maximum length: 255
    Example: red
  • option4 string
    Information of the fourth option of the variant.
    Maximum length: 255
    Example: short
  • required_shipping boolean
    Indicates whether the variant is required to be shipped.
    • true: Shipping is required.
    • false: Shipping is not required.
    Default value: true
  • sku string
    The product SKU. It is distinct from variant.id returned by SHOPLINE.
    Maximum size: 255
    Example: S0000001
  • weight_unit string
    The unit of weight for the variant. Valid values are:
    • g: gram
    • kg: kilogram
    • lb: pound
    • oz: ounce
    • zh_kg: kilogram
    Default value: g
  • compare_at_price string
    The original price of the variant. The value is rounded to two decimal places.
    Default value: 0
    Example: 129.99
  • imageobject
    The image of the variant.
  • id string
    The unique identifier for the variant image.
    Maximum length：64
    Example: 5785060242207917075
  • src string
    The link to the variant image, represented as a URL.
    Maximum length: 255
    Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
  • alt string
    The alternative textual description of the variant image, usually a word or phrase with the characteristics or content of the image.
    Maximum length: 512
    Example: This is an image alt.
  • inventory_tracker boolean
    Indicates whether the inventory tracking is enabled.
    • true: Inventory tracking is enabled.
    • false: Inventory tracking is not enabled.
    Default value: true
  • option3 string
    Information of the third option of the variant.
    Maximum length: 255
    Example: cotton
  • price string
    The selling price of the variant. The value is rounded to two decimal places.
    Default value: 0
    Example: 90.22
  • inventory_policy string
    Indicates whether the variant is allowed to be oversold.
    • deny: overselling not allowed
    • continue: overselling allowed
    Default value: deny
  • option5 string
    Information of the fifth option of the variant.
    Maximum length: 255
    Example: casual
  • taxable boolean
    Indicates whether the variant is subject to tax.
    • true: Tax is required.
    • false: Tax is not required.
    Default value: true
  • weight string
    The weight of the variant. The value is required to be greater than 0，and rounded to two decimal places.
    Example: 0.23
Status Codes
For the complete list of codes and messages, see Http status code.
Response Headers
  • traceId
    A globally unique identifier for the request. It is used to track the request flow throughout the system, allowing for easy location and debugging when issues arise.
Response Body
  • variantobject
    Variant information.
  • created_at string
    The creation date and time of the product variant. Format: ISO 8601.
    Example: 2025-03-06T02:20:26+08:00
  • id string
    The unique identifier for the variant.
    Example: 18057039439794751459380282
  • inventory_tracker boolean
    Indicates whether the inventory tracking is enabled.
    • true: Inventory tracking is enabled.
    • false: Inventory tracking is not enabled.
  • sku string
    The product SKU. It is distinct from variant.id returned by SHOPLINE.
    Example: S00000001
  • taxable boolean
    Indicates whether the variant is subject to tax.
    • true: Tax is required.
    • false: Tax is not required.
  • weight_unit string
    The unit of weight for the variant. Valid values are:
    • g: gram
    • kg: kilogram
    • lb: pound
    • oz: ounce
    • zh_kg: kilogram
  • inventory_item_id string
    The unique identifier for the inventory item.
    Example: 5705499385037070868
  • inventory_policy string
    Indicates whether the variant is allowed to be oversold.
    • deny: overselling not allowed
    • continue: overselling allowed
  • option2 string
    Information of the second option of the variant.
    Example: xl
  • price string
    The selling price of the variant. The value is rounded to two decimal places.
    Example: 90.22
  • required_shipping boolean
    Indicates whether the variant is required to be shipped.
    • true: Shipping is required.
    • false: Shipping is not required.
  • inventory_quantity integer
    The total inventory quantity at all storage locations.
    Example: 99
  • option5 string
    Information of the fifth option of the variant.
    Example: casual
  • product_id string
    The unique identifier for the product corresponding to the variant.
    Example: 16050375155238626683133099
  • barcode string
    The barcode of the variant.
    Example: T00000001
  • compare_at_price string
    The original price of the variant. The value is rounded to two decimal places.
    Example: 129.99
  • imageobject
    The image of the variant.
  • alt string
    The alternative textual description of the variant image, usually a word or phrase with the characteristics or content of the image.
    Example: This is an image alt.
  • id string
    The unique identifier for the variant image.
    Example: 5785060242207917075
  • src string
    The link to the variant image, represented as a URL.
    Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
  • option1 string
    Information of the first option of the variant.
    Example: red
  • option3 string
    Information of the third option of the variant.
    Example: cotton
  • option4 string
    Information of the fourth option of the variant.
    Example: short
  • updated_at string
    The date and time when the variant was last updated. Format: ISO 8601.
    Example: 2025-03-06T02:20:26+08:00
  • weight string
    The weight of the variant. The value is rounded up if it exceeds two decimal places.
    Example: 0.23
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20261201

ParamOptions

— path required
— header required

Body

required
{
  "variant": {
    "weight": "0.23",
    "inventory_policy": null,
    "option2": "xl",
    "option3": "cotton",
    "option5": "casual",
    "required_shipping": null,
    "sku": "S0000001",
    "taxable": null,
    "weight_unit": null,
    "price": "90.22",
    "barcode": "T0000001",
    "compare_at_price": "129.99",
    "image": {
      "alt": "This is an image alt.",
      "id": "5785060242207917075",
      "src": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png"
    },
    "inventory_tracker": null,
    "option1": "red",
    "option4": "short"
  }
}

Language

curl --request PUT \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20261201/products/variants/variant_id.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzU2ZjI1NWE2NjdlZTcwNTk1MzM0ZjVjYzk4NzU5MzBmN2E3NGZjMSIsImV4cCI6MTg3OTQ4MjA3NiwiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjIwMDAyMzQ4ODAiLCJzdG9yZUlkIjoiMTY3MjM2OTcyOTYwNiIsInRpbWVzdGFtcCI6MTc4NDc4NzY3NjY2MSwidmVyc2lvbiI6IlYyIn0.3ZzbGAH4cLU1QR2VPEvMOQInUDvus-C4amkINSQIPuNVlXsFKj0sAt1c0KnUy9MWUOFV9cHlkf7J90r2y1FzpA' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'
Examples
Update a variant
Request
{
  "variant": {
    "barcode": "T0000001",
    "compare_at_price": "99",
    "image": {
      "alt": "my image alt",
      "id": "6089530275430875206",
      "src": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png"
    },
    "inventory_tracker": "true",
    "option1": "L",
    "option2": "White",
    "sku": "S0000001",
    "weight": "0.2",
    "inventory_policy": "deny",
    "price": "90",
    "required_shipping": "true",
    "taxable": "true",
    "weight_unit": "kg"
  }
}
Response
{
  "variant": {
    "product_id": "16060895302856191591063144",
    "weight_unit": "kg",
    "compare_at_price": "99.00",
    "created_at": "2023-08-29T14:59:58+08:00",
    "image": {
      "alt": "my image alt",
      "id": "6089530275430875206",
      "src": "https://img-va.myshopline.com/image/store/2001026666/1653474941510/e46e6189dd5641a3b179444cacdcdd2a_15.png?w=1024&h=1024"
    },
    "inventory_policy": "deny",
    "price": "90.00",
    "barcode": "T0000001",
    "inventory_item_id": "6089530288991379429",
    "option1": "L",
    "required_shipping": true,
    "sku": "S0000001",
    "taxable": true,
    "id": "18060895302863070249743144",
    "option2": "White",
    "updated_at": "2023-08-29T15:10:42+08:00",
    "weight": "0.20",
    "inventory_tracker": true
  }
}
Was this article helpful to you?
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
Legal
Privacy
Terms
Developer Agreement
LinkedInEmail
LinkedInEmail
© Copyright 2013-2026 SHOPLINE Limited.