---
title: CartTransform - GraphQL Admin
description: >-
  A deployed cart transformation function that actively modifies how products
  appear and behave in customer carts. Cart transforms enable sophisticated
  merchandising strategies by programmatically merging, expanding, or updating
  cart line items based on custom business logic.


  Use the `CartTransform` object to:

  - Monitor active bundling and cart modification logic

  - Track transform function deployment status and configuration

  - Manage error handling behavior for cart processing failures

  - Coordinate multiple transforms when running complex merchandising strategies

  - Analyze transform performance and customer interaction patterns


  Each cart transform links to a specific [Shopify
  Function](https://shopify.dev/docs/apps/build/functions) that contains the
  actual cart modification logic. The `blockOnFailure` setting determines
  whether cart processing should halt when the transform encounters errors, or
  whether it should allow customers to proceed with unmodified carts. This
  flexibility ensures merchants can balance feature richness with checkout
  reliability.


  Transform functions operate during cart updates, product additions, and
  checkout initiation, providing multiple touchpoints to enhance the shopping
  experience. They integrate seamlessly with existing cart APIs while extending
  functionality beyond standard product catalog capabilities.


  The function ID connects to your deployed function code, while the
  configuration settings control how the transform behaves in different
  scenarios. Multiple transforms can work together, processing cart
  modifications in sequence to support complex merchandising workflows.


  Learn more about [customized
  bundles](https://shopify.dev/docs/apps/selling-strategies/bundles/add-a-customized-bundle),
  and about the [Cart Transform Function
  API](https://shopify.dev/docs/api/functions/latest/cart-transform).
api_version: unstable
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/CartTransform'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/CartTransform.md'
---

# Cart​Transform

object

Requires `read_cart_transforms` access scope.

A deployed cart transformation function that actively modifies how products appear and behave in customer carts. Cart transforms enable sophisticated merchandising strategies by programmatically merging, expanding, or updating cart line items based on custom business logic.

Use the `CartTransform` object to:

* Monitor active bundling and cart modification logic
* Track transform function deployment status and configuration
* Manage error handling behavior for cart processing failures
* Coordinate multiple transforms when running complex merchandising strategies
* Analyze transform performance and customer interaction patterns

Each cart transform links to a specific [Shopify Function](https://shopify.dev/docs/apps/build/functions) that contains the actual cart modification logic. The `blockOnFailure` setting determines whether cart processing should halt when the transform encounters errors, or whether it should allow customers to proceed with unmodified carts. This flexibility ensures merchants can balance feature richness with checkout reliability.

Transform functions operate during cart updates, product additions, and checkout initiation, providing multiple touchpoints to enhance the shopping experience. They integrate seamlessly with existing cart APIs while extending functionality beyond standard product catalog capabilities.

The function ID connects to your deployed function code, while the configuration settings control how the transform behaves in different scenarios. Multiple transforms can work together, processing cart modifications in sequence to support complex merchandising workflows.

Learn more about [customized bundles](https://shopify.dev/docs/apps/selling-strategies/bundles/add-a-customized-bundle), and about the [Cart Transform Function API](https://shopify.dev/docs/api/functions/latest/cart-transform).

## Fields

* blockOnFailure
* functionId
* id
* metafield
* metafields
* metafieldsByIdentifiers

***

## Map

### Fields and connections with this object

* [CartTransformConnection.nodes](https://shopify.dev/docs/api/admin-graphql/unstable/connections/CartTransformConnection#returns-nodes)
* [CartTransformEdge.node](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CartTransformEdge#field-CartTransformEdge.fields.node)

***

## Queries

* cartTransforms

***

## CartTransform Queries

### Queried by

* [cart​Transforms](https://shopify.dev/docs/api/admin-graphql/unstable/queries/cartTransforms)

***

## Mutations

* cartTransformCreate

***

## CartTransform Mutations

### Mutated by

* [cart​Transform​Create](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/cartTransformCreate)

***

## Interfaces

* HasMetafields
* Node

***

## CartTransform Implements

### Implements

* [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasMetafields)
* [Node](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Node)