Choose a version:

cartLinesUpdate

mutation

Updates one or more merchandise lines on a Cart. You can modify the quantity, swap the merchandise, change custom attributes, or update the selling plan for each line. You can update a maximum of 250 lines per request.

Omitting the attributes field or setting it to null preserves existing line attributes. Pass an empty array to clear all attributes from a line.

Anchor to Arguments

Arguments

Anchor to cartIdcartId

•ID!

required

The ID of the cart.

Anchor to lineslines

•[CartLineUpdateInput!]!

required

The merchandise lines to update.

The input must not contain more than 250 values.

Was this section helpful?

Anchor to CartLinesUpdatePayload returnsCartLinesUpdatePayload returns

Anchor to cartcart •Cart: The updated cart.
Anchor to userErrorsuserErrors •[CartUserError!]! non-null: The list of errors that occurred from executing the mutation.
Anchor to warningswarnings •[CartWarning!]! non-null: A list of warnings that occurred during the mutation.

Was this section helpful?

Examples

cartLinesUpdate reference

Mutation Reference

mutation cartLinesUpdate($cartId: ID!, $lines: [CartLineUpdateInput!]!) {

cartLinesUpdate(cartId: $cartId, lines: $lines) {

cart {

# Cart fields

}

userErrors {

field

message

}

warnings {

# CartWarning fields

}

Input

{

"cartId": "gid://shopify/<objectName>/10079785100",

"lines": [

{

"id": "gid://shopify/<objectName>/10079785100",

"quantity": 1,

"merchandiseId": "gid://shopify/<objectName>/10079785100",

"attributes": [

{

"key": "<your-key>",

"value": "<your-value>"

}

"sellingPlanId": "gid://shopify/<objectName>/10079785100"

}

]

}

Variables

{
  "cartId": "gid://shopify/<objectName>/10079785100",
  "lines": [
    {
      "id": "gid://shopify/<objectName>/10079785100",
      "quantity": 1,
      "merchandiseId": "gid://shopify/<objectName>/10079785100",
      "attributes": [
        {
          "key": "<your-key>",
          "value": "<your-value>"
        }
      ],
      "sellingPlanId": "gid://shopify/<objectName>/10079785100"
    }
  ]
}

Schema

input CartLineUpdateInput {
  id: ID!
  quantity: Int
  merchandiseId: ID
  attributes: [AttributeInput!]
  sellingPlanId: ID
}

input AttributeInput {
  key: String!
  value: String!
}