---
title: subscriptionBillingCycleContractEditCalculate - GraphQL Admin
description: >-
  Starts an asynchronous calculation for changes to a single billing cycle of an

  existing subscription contract. Committing the calculation applies the changes

  only to the selected cycle, leaving the recurring contract unchanged.


  Poll the
  [`subscriptionContractCalculation`](https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionContractCalculation)
  query to review the calculated contract, 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/subscriptionBillingCycleContractEditCalculate
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleContractEditCalculate.md
api_name: admin
api_type: graphql
type: mutation
---

# subscription​Billing​Cycle​Contract​Edit​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 a single billing cycle of an existing subscription contract. Committing the calculation applies the changes only to the selected cycle, leaving the recurring contract unchanged.

Poll the [`subscriptionContractCalculation`](https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionContractCalculation) query to review the calculated contract, 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.

* billing​Cycle​Edit​Input

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

  required

  The input for the single billing cycle contract edit calculation.

* billing​Cycle​Selector

  [Subscription​Billing​Cycle​Selector!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionBillingCycleSelector)

  required

  Selects the billing cycle to edit, by index or date.

* contract​Id

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

  required

  The ID of the subscription contract to edit.

***

## Subscription​Billing​Cycle​Contract​Edit​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​Billing​Cycle​Contract​Edit​Calculate​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingCycleContractEditCalculateUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### subscriptionBillingCycleContractEditCalculate reference