Introduced Cart freeze strategies | HTTP API | commercetools Composable Commerce

Introduced Cart freeze strategies

21 January 2026

Composable Commerce

HTTP API

Enhancement

CartsGraphQL

We have introduced Cart freeze strategies to give you more control over the checkout experience. The existing freeze behavior, which locks valid prices and discounts, is now called SoftFreeze. The new HardFreeze strategy secures the entire Cart state, including shipping costs and expired discounts, ensuring the final price remains unchanged until the Order is placed.

For backward compatibility, if no strategy is specified when freezing a Cart, the SoftFreeze strategy is applied by default.

Changes:

[API] Added the FreezeStrategy enum with SoftFreeze and HardFreeze values.
[API] Added the freezeStrategy field to the Cart type.
[API] Updated the Freeze Cart update action to accept a strategy parameter.
[GraphQL API] Added the FreezeStrategy enum type.
[GraphQL API] Added the freezeStrategy field to the Cart type.
[GraphQL API] Added the strategy input field to the FreezeCart update action.

The following changes were introduced in terms of GraphQL SDL:


enum FreezeStrategy {
  SoftFreeze
  HardFreeze
}

extend type Cart {
  freezeStrategy: FreezeStrategy
}

extend input FreezeCart {
  strategy: FreezeStrategy
}