Shopify Cart Transform Function API

https://shopify.dev/docs/api/functions/latest/cart-transform
Admin
The Cart Transform Function API enables developers to customize cart item pricing and presentation,...
Tokens:42,004
Snippets:222
Trust Score:10
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### cart.transform.run

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Documentation for the cart.transform.run function, including its input, operations, and example implementation.

```APIDOC
## cart.transform.run

### Description
This is the entrypoint for a Cart Transform function. It is invoked by Shopify when a cart is being transformed. The function receives the cart input and returns a list of operations to apply to the cart.

### Method
Function invocation (Cart Transform API)

### Endpoint
cart.transform.run

### Parameters
#### Input
- **cart** (CartInput) - Required - The cart to be transformed.
  - **lines** (List of CartLineInput) - The cart lines.
    - **merchandise** (Merchandise) - The merchandise of the line.
      - **product** (Product) - The product of the merchandise.
        - **giftWrapCost** (Money) - The cost of gift wrapping (custom scalar override).
- **cartTransform** (CartTransformInput) - The configuration for the cart transform.
  - **configuration** (Configuration) - The configuration object (custom scalar override).

### Request Example
```graphql
query CartTransformRun($input: Input!) {
  cartTransformRun(input: $input) {
    operations {
      ... on CartTransformOperation {
        expand {
          cartLines {
            cartLineId
            quantity
            merchandise {
              productVariantId
            }
            price {
              adjustment {
                type
                value
              }
            }
            title
            image {
              url
            }
          }
        }
      }
    }
  }
}
```

### Response
#### Success Response (200)
- **operations** (List of CartTransformOperation) - The operations to apply to the cart.
  - **expand** (ExpandOperation) - An operation that expands a cart line into multiple lines.
    - **cartLines** (List of CartLineInput) - The cart lines to merge.
      - **cartLineId** (ID!) - The globally-unique ID of the cart line.
      - **quantity** (Int!) - The quantity of the cart line to be merged. Max quantity is 2000.
      - **image** (ImageInput) - The image that replaces the existing image for the group of cart line items.
      - **parentVariantId** (ID!) - The globally-unique ID of the product variant that represents the collection of cart line items.
      - **price** (PriceAdjustment) - A change to the original price of a group of items.
      - **title** (String) - The title that replaces the existing title for a group of cart line items.
  - **update** (LineUpdateOperation) - An operation that allows you to override the price, title, and image of a cart line item. Only stores on a Shopify Plus plan can use apps with `update` operations.
    - **cartLineId** (ID!) - The globally-unique ID of the cart line.
    - **image** (ImageInput) - The image that replaces the existing image for the cart line item.
    - **price** (LineUpdateOperationPriceAdjustment) - A change to an item's original price.
    - **title** (String) - The title that replaces the existing title for the cart line item.

### Error Handling
- If the function is not invoked with a named export, it will abort with an error.

### Example
#### Add gift wrapping to cart items
This example demonstrates how to implement an optional gift-wrapping add-on using the Cart Transform expand operation.

1. A customer adds an item to their cart with the "Gift Wrap" attribute.
2. The cart transform function checks for this attribute.
3. The cart line is expanded to add the $5 gift wrap add-on.

#### Entrypoint (Rust)
```rust
use shopify_function::prelude::*;
use std::process;

pub mod cart_transform_run;

#[typegen("./schema.graphql")]
pub mod schema {
    #[query("./src/cart_transform_run.graphql",
        custom_scalar_overrides = {
            "Input.cart.lines.merchandise.product.giftWrapCost.jsonValue" => super::cart_transform_run::Money,
            "Input.cartTransform.configuration.jsonValue" => super::cart_transform_run::Configuration,
        }
    )]
    pub mod cart_transform_run {}
}

fn main() {
    log!("Please invoke a named export.");
    process::abort();
}
```
```

--------------------------------

### Input Object (Rust)

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example input object for the cart transform function, showing a cart with one line item and a customer with the hasAnyTag flag set to true.

```json
{
    "cart": {
      "lines": [
        {
          "id": "gid://shopify/CartLine/6727c32a-9829-445b-8460-71774972fa55",
          "quantity": 1,
          "cost": {
            "amountPerQuantity": {
              "amount": "749.95"
            }
          },
          "merchandise": {
            "__typename": "ProductVariant",
            "product": {
              "title": "The Collection Snowboard: Liquid"
            }
          }
        }
      ],
      "buyerIdentity": {
        "customer": {
          "id": "gid://shopify/Customer/8808655552742",
          "hasAnyTag": true
        }
      }
    }
  }
```

--------------------------------

### Cart transform output JSON for bundle expansion

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example output JSON for a cart transform run that expands a bundle into three component parts. Shows the lineExpand operation with cartLineId, expandedCartItems, and a title.

```json
{
  "operations": [
    {
      "lineExpand": {
        "cartLineId": "1",
        "expandedCartItems": [
          {
            "merchandiseId": "gid://shopify/ProductVariant/2",
            "price": {
              "adjustment": {
                "fixedPricePerUnit": {
                  "amount": "25.0"
                }
              }
            },
            "quantity": 1
          },
          {
            "merchandiseId": "gid://shopify/ProductVariant/3",
            "price": {
              "adjustment": {
                "fixedPricePerUnit": {
                  "amount": "25.0"
                }
              }
            },
            "quantity": 1
          },
          {
            "merchandiseId": "gid://shopify/ProductVariant/4",
            "price": {
              "adjustment": {
                "fixedPricePerUnit": {
                  "amount": "25.0"
                }
              }
            },
            "quantity": 1
          }
        ],
        "title": "Holiday Package"
      }
    }
  ]
}
```

--------------------------------

### Output JSON for Rust cart transform

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example output JSON for the Rust cart transform function, showing a lineUpdate operation with a fixedPricePerUnit amount of 579.95.

```json
{
  "operations": [
    {
      "lineUpdate": {
        "cartLineId": "gid://shopify/CartLine/a8a95ef8-5c64-4052-9939-250ea091bc9c",
        "price": {
          "adjustment": {
            "fixedPricePerUnit": {
              "amount": "579.95"
            }
          }
        }
      }
    }
  ]
}
```

--------------------------------

### Cart transform output JSON for lineExpand

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example output JSON for the cart transform function, showing a lineExpand operation that replaces a cart line with two items: the original product and the gift wrap add-on. The fixed prices are in the presentment currency.

```json
{
  "operations": [
    {
      "lineExpand": {
        "cartLineId": "gid://shopify/CartLine/2",
        "expandedCartItems": [
          {
            "merchandiseId": "gid://shopify/ProductVariant/456",
            "price": {
              "adjustment": {
                "fixedPricePerUnit": {
                  "amount": "100.0"
                }
              }
            },
            "quantity": 1
          },
          {
            "merchandiseId": "gid://shopify/ProductVariant/2",
            "price": {
              "adjustment": {
                "fixedPricePerUnit": {
                  "amount": "5.0"
                }
              }
            },
            "quantity": 1
          }
        ],
        "title": "Something that is wrapped"
      }
    }
  ]
}
```

--------------------------------

### Output JSON for linesMerge operation

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example output JSON for a cart transform function that merges cart lines into a bundle. It specifies the cart lines to merge, the parent variant, a bundle title, and a 10% price decrease.

```json
{
  "operations": [
    {
      "linesMerge": {
        "cartLines": [
          {
            "cartLineId": "gid://shopify/CartLine/1",
            "quantity": 1
          },
          {
            "cartLineId": "gid://shopify/CartLine/2", 
            "quantity": 1
          }
        ],
        "parentVariantId": "gid://shopify/ProductVariant/789",
        "title": "SKU 123 Bundle",
        "price": {
          "percentageDecrease": {
            "value": 10
          }
        }
      }
    }
  ]
}
```

--------------------------------

### Input object for beauty bundle cart

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example input object for a cart transform function that contains three cart lines with beauty bundle component metafields for a cleanser, toner, and moisturizer.

```json
{
  "cart": {
    "lines": [
      {
        "id": "gid://shopify/CartLine/1",
        "quantity": 2,
        "merchandise": {
          "__typename": "ProductVariant",
          "product": {
            "beautyBundleComponent": {
              "value": "beauty-product-bundle-component-cleanser",
              "type": "single_line_text_field"
            }
          }
        }
      },
      {
        "id": "gid://shopify/CartLine/2",
        "quantity": 1,
        "merchandise": {
          "__typename": "ProductVariant",
          "product": {
            "beautyBundleComponent": {
              "value": "beauty-product-bundle-component-toner",
              "type": "single_line_text_field"
            }
          }
        }
      },
      {
        "id": "gid://shopify/CartLine/3",
        "quantity": 1,
        "merchandise": {
          "__typename": "ProductVariant",
          "product": {
            "beautyBundleComponent": {
              "value": "beauty-product-bundle-component-moisturizer",
              "type": "single_line_text_field"
            }
          }
        }
      }
    ]
  }
}
```

--------------------------------

### Rust input object for cart transform

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example input object for the Rust cart transform function. It shows a cart with four lines, two sharing the same SKU, and a wholesale customer.

```json
{
  "cart": {
    "lines": [
      {
        "id": "gid://shopify/CartLine/1",
        "quantity": 1,
        "merchandise": {
          "__typename": "ProductVariant",
          "sku": "123"
        }
      },
      {
        "id": "gid://shopify/CartLine/2",
        "quantity": 1,
        "merchandise": {
          "__typename": "ProductVariant", 
          "sku": "123"
        }
      },
      {
        "id": "gid://shopify/CartLine/3",
        "quantity": 1,
        "merchandise": {
          "__typename": "ProductVariant",
          "sku": "456"
        }
      },
      {
        "id": "gid://shopify/CartLine/4",
        "quantity": 1,
        "merchandise": {
          "__typename": "ProductVariant",
          "sku": "789"
        }
      }
    ],
    "buyerIdentity": {
      "customer": {
        "isWholesale": true
      }
    }
  }
}
```

--------------------------------

### Rust input object for combo meal cart

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example input object for a Rust cart transform function. It shows a cart with three lines: two burgers, one fries, and one drink, each with the comboMealComponent metafield value and type.

```json
{
  "cart": {
    "lines": [
      {
        "id": "gid://shopify/CartLine/1",
        "quantity": 2,
        "merchandise": {
          "__typename": "ProductVariant",
          "product": {
            "comboMealComponent": {
              "value": "combo-meal-component-burger",
              "type": "single_line_text_field"
            }
          }
        }
      },
      {
        "id": "gid://shopify/CartLine/2", 
        "quantity": 1,
        "merchandise": {
          "__typename": "ProductVariant",
          "product": {
            "comboMealComponent": {
              "value": "combo-meal-component-fries",
              "type": "single_line_text_field"
            }
          }
        }
      },
      {
        "id": "gid://shopify/CartLine/3",
        "quantity": 1,
        "merchandise": {
          "__typename": "ProductVariant",
          "product": {
            "comboMealComponent": {
              "value": "combo-meal-component-drink",
              "type": "single_line_text_field"
            }
          }
        }
      }
    ]
  }
}
```

--------------------------------

### Input object for Rust cart transform (metaobject bundle)

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example input object for the Rust cart transform function. It shows the metaobject fields (component variants, bundle title, discount percentage, parent variant) and the cart lines with their merchandise variant IDs.

```json
{
  "shop": {
    "bundleConfig": {
      "componentVariants": {
        "jsonValue": [
          "gid://shopify/ProductVariant/101",
          "gid://shopify/ProductVariant/102",
          "gid://shopify/ProductVariant/103"
        ]
      },
      "bundleTitle": {
        "value": "Morning Routine Bundle"
      },
      "discountPercentage": {
        "value": "10.0"
      },
      "parentVariant": {
        "value": "gid://shopify/ProductVariant/200"
      }
    }
  },
  "cart": {
    "lines": [
      {
        "id": "gid://shopify/CartLine/1",
        "quantity": 1,
        "merchandise": {
          "__typename": "ProductVariant",
          "id": "gid://shopify/ProductVariant/101"
        }
      },
      {
        "id": "gid://shopify/CartLine/2",
        "quantity": 1,
        "merchandise": {
          "__typename": "ProductVariant",
          "id": "gid://shopify/ProductVariant/102"
        }
      },
      {
        "id": "gid://shopify/CartLine/3",
        "quantity": 1,
        "merchandise": {
          "__typename": "ProductVariant",
          "id": "gid://shopify/ProductVariant/103"
        }
      }
    ]
  }
}
```

--------------------------------

### Input Object (Rust)

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example input object for a Shopify cart transform function, shown for the Rust implementation. Contains two cart lines: one without assembly service and one with assembly service, plus the cart transform configuration specifying the assembly service variant ID.

```json
{
  "presentmentCurrencyRate": "1.0",
  "cart": {
    "lines": [
      {
        "id": "gid://shopify/CartLine/1",
        "quantity": 1,
        "cost": {
          "amountPerQuantity": {
            "amount": "100.0",
            "currencyCode": "CAD"
          }
        },
        "assemblyServiceAdded": {
          "value": "No"
        },
        "merchandise": {
          "__typename": "ProductVariant",
          "id": "gid://shopify/ProductVariant/1099",
          "title": "Something without assembly service",
          "product": {
            "assemblyServiceCost": {
              "type": "money",
              "jsonValue": {
                "amount": "25.00",
                "currencyCode": "CAD"
              }
            }
          }
        }
      },
      {
        "id": "gid://shopify/CartLine/2",
        "quantity": 5,
        "cost": {
          "amountPerQuantity": {
            "amount": "100.0",
            "currencyCode": "CAD"
          }
        },
        "assemblyServiceAdded": {
          "value": "Yes"
        },
        "merchandise": {
          "__typename": "ProductVariant",
          "id": "gid://shopify/ProductVariant/456",
          "title": "Something with an assembly service",
          "product": {
            "assemblyServiceCost": {
              "type": "money",
              "jsonValue": {
                "amount": "25.00",
                "currencyCode": "CAD"
              }
            }
          }
        }
      }
    ]
  },
  "cartTransform": {
    "configuration": {
      "jsonValue": {
        "assemblyServiceVariantId": "gid://shopify/ProductVariant/2"
      }
    }
  }
}
```

--------------------------------

### Output JSON for Rust cart transform

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example output JSON for a Rust cart transform function. Shows the linesMerge operation with an empty attributes array, three cart lines, parent variant, bundle title, and a 10% price decrease.

```json
{
  "operations": [
    {
      "linesMerge": {
        "attributes": [],
        "cartLines": [
          {
            "cartLineId": "gid://shopify/CartLine/1",
            "quantity": 1
          },
          {
            "cartLineId": "gid://shopify/CartLine/2",
            "quantity": 1
          },
          {
            "cartLineId": "gid://shopify/CartLine/3",
            "quantity": 1
          }
        ],
        "parentVariantId": "gid://shopify/ProductVariant/200",
        "title": "Morning Routine Bundle",
        "price": {
          "percentageDecrease": {
            "value": "10.0"
          }
        }
      }
    }
  ]
}
```

--------------------------------

### Cart Transform Input Object (Rust)

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example input object for a cart transform expand operation in Rust. It shows a cart line for a "Holiday Package" product variant with a bundledComponentData metafield containing three component variants, each priced at 25.00.

```json
{
  "presentmentCurrencyRate": "1.0",
  "cart": {
    "lines": [
      {
        "id": "1",
        "quantity": 1,
        "merchandise": {
          "__typename": "ProductVariant",
          "id": "gid://shopify/ProductVariant/1",
          "title": "Holiday Package",
          "product": {
            "bundledComponentData": {
              "jsonValue": {
                "components": [
                  {
                    "id": "gid://shopify/ProductVariant/2",
                    "price": "25.00"
                  },
                  {
                    "id": "gid://shopify/ProductVariant/3",
                    "price": "25.00"
                  },
                  {
                    "id": "gid://shopify/ProductVariant/4",
                    "price": "25.00"
                  }
                ]
              }
            }
          }
        }
      }
    ]
  }
}
```

--------------------------------

### Cart Transform Input Object (Rust)

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example input object for the cart transform, showing a cart line with a custom image attribute and another without it. The custom image URL must be a Shopify CDN URL or a publicly accessible hotlinkable URL.

```json
{
    "cart": {
      "lines": [
        {
          "id": "gid://shopify/CartLine/02d86da8-a110-4d79-bd30-03f50e9a1ee0",
          "custom_image_attribute": {
            "value": "https://cdn.shopify.com/s/files/1/0746/5248/3814/files/396_5137_w450.jpg?v=1746497836"
          },
          "merchandise": {
            "__typename": "ProductVariant",
            "product": {
              "title": "The Collection Snowboard: Liquid"
            }
          }
        },
        {
          "id": "gid://shopify/CartLine/859a8af9-bbe0-41a2-adff-8060af179a5e",
          "custom_image_attribute": null,
          "merchandise": {
            "__typename": "ProductVariant",
            "product": {
              "title": "The Collection Snowboard: Liquid"
            }
          }
        }
      ]
    }
  }
```

--------------------------------

### Cart transform output JSON (Rust)

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example output JSON from the cart transform function, showing a lineExpand operation with two expanded cart items: the original product and the assembly service variant. The prices are fixed per unit and the title is set to "Something with an assembly service".

```json
{
  "operations": [
    {
      "lineExpand": {
        "cartLineId": "gid://shopify/CartLine/2",
        "expandedCartItems": [
          {
            "merchandiseId": "gid://shopify/ProductVariant/456",
            "price": {
              "adjustment": {
                "fixedPricePerUnit": {
                  "amount": "100.0"
                }
              }
            },
            "quantity": 1
          },
          {
            "merchandiseId": "gid://shopify/ProductVariant/2",
            "price": {
              "adjustment": {
                "fixedPricePerUnit": {
                  "amount": "25.0"
                }
              }
            },
            "quantity": 1
          }
        ],
        "title": "Something with an assembly service"
      }
    }
  ]
}

```

--------------------------------

### Cart transform output JSON (Rust)

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example output JSON for the cart transform function, showing a linesMerge operation that combines three cart lines into a bundle with a 15% price decrease. The output includes the parentVariantId, title, and the cart line IDs with quantities.

```json
{
  "operations": [
    {
      "linesMerge": {
        "attributes": [],
        "cartLines": [
          {
            "cartLineId": "gid://shopify/CartLine/1",
            "quantity": 1
          },
          {
            "cartLineId": "gid://shopify/CartLine/2",
            "quantity": 1
          },
          {
            "cartLineId": "gid://shopify/CartLine/3",
            "quantity": 1
          }
        ],
        "parentVariantId": "gid://shopify/ProductVariant/789",
        "price": {
          "percentageDecrease": {
            "value": "15.0"
          }
        },
        "title": "Beauty Product Bundle"
      }
    }
  ]
}
```

--------------------------------

### Output JSON for linesMerge operation

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example output JSON for a cart transform function that merges cart lines into a bundle with a 15% percentage decrease. The cartLines array lists the line IDs to merge, parentVariantId identifies the bundle variant, and title sets the bundle name.

```json
{
  "operations": [
    {
      "linesMerge": {
        "cartLines": [
          {
            "cartLineId": "gid://shopify/CartLine/1",
            "quantity": 1
          },
          {
            "cartLineId": "gid://shopify/CartLine/2", 
            "quantity": 1
          },
          {
            "cartLineId": "gid://shopify/CartLine/3",
            "quantity": 1
          }
        ],
        "parentVariantId": "gid://shopify/ProductVariant/789",
        "title": "Beauty Product Bundle",
        "price": {
          "percentageDecrease": {
            "value": 15
          }
        }
      }
    }
  ]
}
```

--------------------------------

### Output JSON for JavaScript cart transform

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example output JSON for a JavaScript cart transform function. Shows the linesMerge operation with three cart lines, parent variant, bundle title, and a 10% price decrease. Unlike the Rust output, this example omits the attributes field.

```json
{
  "operations": [
    {
      "linesMerge": {
        "cartLines": [
          {
            "cartLineId": "gid://shopify/CartLine/1",
            "quantity": 1
          },
          {
            "cartLineId": "gid://shopify/CartLine/2",
            "quantity": 1
          },
          {
            "cartLineId": "gid://shopify/CartLine/3",
            "quantity": 1
          }
        ],
        "parentVariantId": "gid://shopify/ProductVariant/200",
        "title": "Morning Routine Bundle",
        "price": {
          "percentageDecrease": {
            "value": "10.0"
          }
        }
      }
    }
  ]
}
```

--------------------------------

### Input query for Rust cart transform (metaobject bundle)

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Input query for the Rust cart transform function. It fetches the bundle configuration from a shop-level metaobject (type "$app:bundle_config", handle "morning-routine") and the cart lines with their merchandise variant IDs.

```graphql
query Input {
  shop {
    bundleConfig: metaobject(handle: { type: "$app:bundle_config", handle: "morning-routine" }) {
      componentVariants: field(key: "component_variants") {
        jsonValue
      }
      bundleTitle: field(key: "bundle_title") {
        value
      }
      discountPercentage: field(key: "discount_percentage") {
        value
      }
      parentVariant: field(key: "parent_variant") {
        value
      }
    }
  }
  cart {
    lines {
      id
      quantity
      merchandise {
        __typename
        ... on ProductVariant {
          id
        }
      }
    }
  }
}
```

--------------------------------

### Scaffold a cart transform function with Shopify CLI

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Use this command in your terminal to generate a new Shopify Functions extension with the cart_transform template. Run it from your project directory after installing the Shopify CLI.

```terminal
shopify app generate extension --template cart_transform
```

--------------------------------

### Cart Transform Input Query (Rust)

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

GraphQL input query for the cart transform run in Rust. It fetches the presentment currency rate and cart lines, including the product's bundledComponentData metafield (namespace "$app", key "function-configuration") to read bundle configuration.

```graphql
query Input {
  presentmentCurrencyRate
  cart {
    lines {
      id
      quantity
      merchandise {
        __typename
        ... on ProductVariant {
          id
          title
          product {
            bundledComponentData: metafield(namespace: "$app", key: "function-configuration") {
              jsonValue
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Cart Transform Input Query (JavaScript)

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

GraphQL input query for the cart transform run in JavaScript. It fetches the presentment currency rate and cart lines, including the product's bundledComponentData metafield (namespace "$app", key "function-configuration") to read bundle configuration.

```graphql
query RunInput {
  presentmentCurrencyRate
  cart {
    lines {
      id
      quantity
      merchandise {
        __typename
        ... on ProductVariant {
          id
          title
          product {
            bundledComponentData: metafield(namespace: "$app", key: "function-configuration") {
              jsonValue
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Cart Transform Update Operation Output JSON

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example output JSON for a cart transform update operation that expands a cart line into multiple items, each with a fixed price per unit of 25.00.

```json
{
    "operations": [
        {
            "lineExpand": {
                "cartLineId": "1",
                "expandedCartItems": [
                    {
                        "merchandiseId": "gid://shopify/ProductVariant/2",
                        "price": {
                            "adjustment": {
                                "fixedPricePerUnit": {
                                    "amount": "25.00"
                                }
                            }
                        },
                        "quantity": 1
                    },
                    {
                        "merchandiseId": "gid://shopify/ProductVariant/3",
                        "price": {
                            "adjustment": {
                                "fixedPricePerUnit": {
                                    "amount": "25.00"
                                }
                            }
                        },
                        "quantity": 1
                    },
                    {
                        "merchandiseId": "gid://shopify/ProductVariant/4",
                        "price": {
                            "adjustment": {
                                "fixedPricePerUnit": {
                                    "amount": "25.00"
                                }
                            }
                        },
                        "quantity": 1
                    }
                ]
            }
        }
    ]
}
```

--------------------------------

### Rust input query for beauty bundle

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Input query for a Rust cart transform function that fetches cart lines and the beauty bundle component metafield from each product variant.

```graphql
query Input {
  cart {
    lines {
      id
      quantity
      merchandise {
        __typename
        ... on ProductVariant {
          product {
            beautyBundleComponent: metafield(namespace: "custom", key: "beauty-product-bundle-component-type") {
              value
              type
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Cart Transform Output JSON (Rust)

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example output JSON for the Rust cart transform function. Shows a single lineUpdate operation with the cart line ID, image URL, and title "Designed by ME".

```json
{
  "operations": [
    {
      "lineUpdate": {
        "cartLineId": "gid://shopify/CartLine/02d86da8-a110-4d79-bd30-03f50e9a1ee0",
        "image": {
          "url": "https://cdn.shopify.com/s/files/1/0746/5248/3814/files/396_5137_w450.jpg?v=1746497836"
        },
        "title": "Designed by ME"
      }
    }
  ]
}
```

--------------------------------

### Cart Transform Update Operation Output JSON

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Example output JSON for a cart transform update operation that sets a fixed price per unit for a specific cart line. The cartLineId must be a valid Shopify CartLine GID.

```json
{
    "operations": [
      {
        "lineUpdate": {
          "cartLineId": "gid://shopify/CartLine/a8a95ef8-5c64-4052-9939-250ea091bc9c",
          "price": {
            "adjustment": {
              "fixedPricePerUnit": {
                "amount": 579.95
              }
            }
          }
        }
      }
    ]
  }
```

--------------------------------

### Rust Entrypoint for Cart Transform Expand Operation

Source: https://shopify.dev/docs/api/functions/latest/cart-transform

Rust entrypoint for a cart transform function that expands cart lines with an assembly service add-on. It declares the schema module with custom scalar overrides for the assembly service cost and function configuration, and aborts if invoked directly.

```rust
use shopify_function::prelude::*;
use std::process;

pub mod cart_transform_run;

#[typegen("./schema.graphql")]
pub mod schema {
    #[query("./src/cart_transform_run.graphql",
    custom_scalar_overrides = {
        "Input.cart.lines.merchandise.product.assemblyServiceCost.jsonValue" => super::cart_transform_run::Money,
        "Input.cartTransform.configuration.jsonValue" => super::cart_transform_run::Configuration,
    }
)]
    pub mod cart_transform_run {}
}

fn main() {
    log!("Please invoke a named export.");
    process::abort();
}
```
Tokens:
Raw