---
title: >-
  New SubscriptionContractCalculation API for subscription management - Shopify
  developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/new-subscriptioncontractcalculation-api-for-subscription-management
  md: >-
    https://shopify.dev/changelog/posts/new-subscriptioncontractcalculation-api-for-subscription-management.md
metadata:
  effectiveApiVersion: 2026-10
  affectedApi: []
  primaryTag:
    displayName: Platform
    handle: platform
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: true
  createdAt: '2026-10-01T10:53:28-04:00'
  postedAt: '2026-10-01T11:30:00-04:00'
  updatedAt: '2026-10-01T16:40:22-04:00'
  effectiveAt: '2026-10-01T11:30:00-04:00'
---

October 1, 2026

# New SubscriptionContractCalculation API for subscription management

DateOctober 1, 2026

Version[2026-10](https://shopify.dev/changelog?api_version=2026-10)

FlagsNew[Action required](https://shopify.dev/changelog?action_required=true)

SurfacesPlatform

A new SubscriptionContractCalculation API is now available to manage subscriptions. This new API runs subscription contract edits through Shopify's checkout engine, enabling new capabilities:

* Shopify Functions, including cart transforms and delivery customizations are supported during contract calculations
* Contract edits align with what the subscriber sees during billing
* Get a preview of the full calculated contract (totals, delivery options, and warnings) before persisting any changes

Developers using the SubscriptionDraft API should migrate to SubscriptionContractCalculation API. The SubscriptionDraft API will remain available but will not support the new capabilities.

See the [migration guide](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/migrate-to-subscription-calculation-api) and updated subscriptions [build guides](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts) and [API docs](https://shopify.dev/docs/api/admin-graphql/2026-10/unions/SubscriptionContractCalculation).