Choose a version:

cartLinesAdd

mutation

Adds a merchandise line to the cart.

Arguments

Anchor to cartIdcartId •ID! required: The ID of the cart.
Anchor to lineslines •[CartLineInput!]! required: A list of merchandise lines to add to the cart.

The input must not contain more than 250 values.

Was this section helpful?

Anchor to CartLinesAddPayload returnsCartLinesAddPayload 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?

Mutation Reference

mutation cartLinesAdd($cartId: ID!, $lines: [CartLineInput!]!) {

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

cart {

# Cart fields

}

userErrors {

field

message

}

warnings {

# CartWarning fields

}

Input

{

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

"lines": [

{

"attributes": [

{

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

"value": "<your-value>"

}

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

"quantity": 1,

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

}

]

}

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

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

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