Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Reservation Lifecycle

A reservation represents a temporary hold on a specific quantity of a product variant.

Reservations are created, updated, and released based on cart activity and follow a predictable lifecycle.

When Reservations Are Created

Reservations are created when a customer performs a valid cart action, such as:

  • Adding a product to the cart
  • Increasing and decreasing the quantity of an existing cart item

Reservations are not created when a product page is viewed.

Active Reservations

A reservation becomes active immediately after it is successfully created.

An active reservation:

  • Holds a specific quantity of a variant
  • Is scoped to a single session
  • Has an associated expiration timer

Reservation Extension

If the customer continues interacting with the cart, the reservation timer counts down.

If a reservation expires, the customer can renew it.

Reservation Release

A reserved product is released when:

  • The reserved product is removed from the cart
  • The reserved quantity is reduced
  • Checkout is successfully completed

Once released, the product becomes available to other sessions.

Reservation Expiration

If no qualifying cart activity occurs before the timer expires, the reservation expires and is automatically released.

Expired reservations do not require manual cleanup.