Choose a version:

cartTransformCreate

mutation

Requires write_cart_transforms access scope. Also: The shop must have upgraded to Checkout Extensibility and the user must have products and preferences permission to create a cart transform function.

Create a CartTransform function to the Shop.

Arguments

Anchor to blockOnFailureblockOnFailure •BooleanDefault:false: Whether a run failure should block cart and checkout operations.
Anchor to functionIdfunctionId •String!required: The identifier of the Function providing the cart transform.
Anchor to metafieldsmetafields •[MetafieldInput!]Default:[]: Additional metafields to associate to the cart transform.

Was this section helpful?

Anchor to CartTransformCreatePayload returnsCartTransformCreatePayload returns

Anchor to cartTransformcartTransform •CartTransform: The newly created cart transform function.
Anchor to userErrorsuserErrors •[CartTransformCreateUserError!]!non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Mutation Reference

mutation cartTransformCreate($blockOnFailure: Boolean, $functionId: String!, $metafields: [MetafieldInput!]) {

cartTransformCreate(blockOnFailure: $blockOnFailure, functionId: $functionId, metafields: $metafields) {

cartTransform {

# CartTransform fields

}

userErrors {

field

message

}

Input

{

"blockOnFailure": true,

"functionId": "<your-functionId>",

"metafields": [

{

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

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

"namespace": "<your-namespace>",

"type": "<your-type>",

"value": "<your-value>"

}

]

}

{
  "blockOnFailure": true,
  "functionId": "<your-functionId>",
  "metafields": [
    {
      "id": "gid://shopify/<objectName>/10079785100",
      "key": "<your-key>",
      "namespace": "<your-namespace>",
      "type": "<your-type>",
      "value": "<your-value>"
    }
  ]
}

input MetafieldInput {
  description: String
  id: ID
  key: String
  namespace: String
  type: String
  value: String
}