---
title: subscriptionContractUpdateCalculate - GraphQL Admin
description: >-
  Starts an asynchronous calculation for changes to an existing subscription

  contract. The changes aren't applied to the contract until you commit the

  calculation, and fields omitted from the input remain unchanged.


  Poll the
  [`subscriptionContractCalculation`](https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionContractCalculation)
  query to review the calculated contract, its projected order totals, and any

  warnings, then commit it with the
  [`subscriptionContractCalculationCommit`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCalculationCommit)
  mutation.


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

# subscription​Contract​Update​Calculate

mutation

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

Starts an asynchronous calculation for changes to an existing subscription contract. The changes aren't applied to the contract until you commit the calculation, and fields omitted from the input remain unchanged.

Poll the [`subscriptionContractCalculation`](https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionContractCalculation) query to review the calculated contract, its projected order totals, and any warnings, then commit it with the [`subscriptionContractCalculationCommit`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCalculationCommit) mutation.

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

## Arguments

* actor

  [Subscription​Actor](https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionActor)

  The actor who initiated a subscription action.

* contract​Id

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

  required

  The ID of the subscription contract to update.

* contract​Update​Input

  [Subscription​Contract​Calculation​Contract​Update​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationContractUpdateInput)

  required

  The input for the subscription contract update calculation.

***

## Subscription​Contract​Update​Calculate​Payload returns

* subscription​Contract​Calculation

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

  The result of the subscription contract calculation operation.

* user​Errors

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

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### subscriptionContractUpdateCalculate reference