Cart Transform

Shopify Plus required. Cart Transform uses the Cart Transform API, which is only available on Shopify Plus plans.

Cart Transform lets you change how products appear in the cart and checkout. Merge multiple line items into a single visual bundle, update product titles and images, or set custom prices — all without changing the underlying products.

Operation Types

Update Line Items (UL)

Change the title, image, or price of individual cart items. This is useful for custom line item presentation — for example, showing a personalized product name or a promotional image.

Merge Items (MI)

Combine multiple line items into a single bundle line item. Customers see one bundled product instead of individual items. You configure:

• Which items to merge
• The bundle’s display title
• The bundle’s display image
• The bundle’s price (custom or sum of items)
• The parent product for the merged line

Merge Items Configuration

Scope

Scope	Description
All (global)	Bundle applies to all markets
Specific	Bundle applies only to specific markets

For market-specific bundles, add a market condition with matching operators.

Bundle Item Arrays

Define which items make up the bundle:

• Select product/variant IDs
• Set required quantity for each item
• Configure the display metadata (title, image, price)

Settings

Setting	Description
expandOperations	Allow expand operations on the bundle
blockOnFailure	Block checkout if the transform fails

Setting Up Cart Transform

Step 1: Create a New Campaign

1. Open PowerX from your Shopify admin.
2. Click Create Campaign.
3. Select Cart Transform as the function type.
4. Name your campaign (e.g., “Summer Bundle”).

Step 2: Choose Operation Type

Select Update Line Items to modify individual items, or Merge Items to create a visual bundle.

Step 3: Configure the Transform

For Merge Items:

1. Select the products/variants that form the bundle.
2. Set the required quantity for each item.
3. Enter the bundle display title (e.g., “Summer Bundle”).
4. Upload or select the bundle display image.
5. Set the bundle price — either a custom amount or the sum of individual item prices.
6. Select the parent product for the merged line item.

For Update Line Items:

1. Select which line items to update.
2. Enter the new title, image URL, or price as needed.

Step 4: Set Scope

Choose the scope:

• Global — applies everywhere.
• Specific — add market conditions to target specific markets.

Step 5: Activate

Review and toggle to Active.

Common Use Cases

Visual Bundle

Merge 3 items into a single “Summer Bundle” line item at checkout.

• Operation: Merge Items
• Items: Specific product/variant IDs (e.g., sunglasses + hat + sunscreen)
• Title: “Summer Bundle”
• Image: Custom bundle image
• Price: Custom bundle price

Market-Specific Bundle Pricing

Offer different bundle prices for different markets.

• Operation: Merge Items
• Scope: Specific (market-based)
• Market condition: Market handle matches target
• Price: Different price per market

Custom Line Item Presentation

Show a personalized product title for engraved or customized items.

• Operation: Update Line Items
• Select: Items with a specific line item property
• New title: Include the personalization text

Troubleshooting

Bundle not merging items?

• Verify all required items are in the cart at the correct quantities.
• Check that the campaign is Active.
• Ensure the product/variant IDs match your Shopify products.

Bundle showing wrong price?

• Review the bundle price configuration.
• For market-specific bundles, verify the market condition is matching correctly.

Checkout blocked unexpectedly?

• Check the blockOnFailure setting — if enabled and the transform encounters an error, checkout will be blocked.
• Disable blockOnFailure for a softer failure mode.