---
title: subscriptionContractCalculationCommit - GraphQL Admin
description: >-
  Commits a succeeded subscription contract calculation. For a create or update

  calculation, committing makes the calculated contract the contract's new

  active version used for future billing. For a billing cycle edit, committing

  applies the calculated contract only to the selected cycle. A calculation that

  provides `fetchAvailableDeliveryOptions` only discovered delivery options and

  can't be committed. Create a new calculation with the chosen delivery method,

  then commit it.


  The calculation must be in a succeeded state, which you can confirm with the
  [`subscriptionContractCalculation`](https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionContractCalculation)

  query. Returns the committed contract as a
  [`SubscriptionContract`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContract),

  or a `SubscriptionBillingCycleEditedContract` for a billing cycle edit.


  Learn how to [build a subscription
  contract](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/build-a-subscription-contract).
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCalculationCommit
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCalculationCommit.md
api_name: admin
api_type: graphql
type: mutation
---

# subscription​Contract​Calculation​Commit

mutation

Requires `write_own_subscription_contracts` access scope. Also: The user must have manage\_orders\_information permission.

Commits a succeeded subscription contract calculation. For a create or update calculation, committing makes the calculated contract the contract's new active version used for future billing. For a billing cycle edit, committing applies the calculated contract only to the selected cycle. A calculation that provides `fetchAvailableDeliveryOptions` only discovered delivery options and can't be committed. Create a new calculation with the chosen delivery method, then commit it.

The calculation must be in a succeeded state, which you can confirm with the [`subscriptionContractCalculation`](https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionContractCalculation) query. Returns the committed contract as a [`SubscriptionContract`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContract), or a `SubscriptionBillingCycleEditedContract` for a billing cycle edit.

Learn how to [build a subscription contract](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/build-a-subscription-contract).

## Arguments

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  required

  The ID of the Subscription Contract Calculation to commit.

***

## Subscription​Contract​Calculation​Commit​Payload returns

* contract

  [Subscription​Committed​Contract](https://shopify.dev/docs/api/admin-graphql/latest/unions/SubscriptionCommittedContract)

  The contract produced by committing the calculation. A create or update returns a SubscriptionContract; a billing cycle edit returns a SubscriptionBillingCycleEditedContract.

* user​Errors

  [\[Subscription​Contract​Calculation​Commit​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContractCalculationCommitUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### subscriptionContractCalculationCommit reference