---
title: SubscriptionContractCalculationBillingCycleEditInput - GraphQL Admin
description: >-
  The input fields for editing a subscription contract for a single billing
  cycle, used for

  contract calculation. Any field provided will update or replace the
  corresponding value for

  the targeted cycle. Fields that are omitted will be left unchanged.
  Contract-level

  attributes such as billing policy, delivery policy, and payment method cannot
  be changed by

  a billing cycle edit.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationBillingCycleEditInput
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationBillingCycleEditInput.md
api_name: admin
api_type: graphql
type: input-object
---

# Subscription​Contract​Calculation​Billing​Cycle​Edit​Input

input\_object

The input fields for editing a subscription contract for a single billing cycle, used for contract calculation. Any field provided will update or replace the corresponding value for the targeted cycle. Fields that are omitted will be left unchanged. Contract-level attributes such as billing policy, delivery policy, and payment method cannot be changed by a billing cycle edit.

## Fields

* custom​Attributes

  [\[Attribute​Input!\]](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/AttributeInput)

  The custom attributes for the targeted billing cycle. Replaces all existing attributes. To remove all attributes, provide an empty array (`[]`).

* delivery​Method

  [Subscription​Contract​Calculation​Delivery​Method​Input](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationDeliveryMethodInput)

  The delivery method for the targeted billing cycle. Replaces the existing delivery method. Provide `none` to remove the delivery method. Provide `fetchAvailableDeliveryOptions` instead of a method to discover options for an address without changing the committed delivery method.

* discount​Codes

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

  requiredDefault:\[]

  The discount codes to apply to the targeted billing cycle during this calculation. Applied codes are resolved into manual discounts; discount codes aren't persisted as codes, so there is nothing to preserve or replace across calculations. Defaults to an empty array (apply no discount codes).

* lines

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

  The subscription lines to set for the targeted billing cycle. Replaces all existing lines with the contents of this array. At least one line is required.

  * To update an existing line within the new set, include its `id`.
  * To add a new line, omit its `id`.

* manual​Discounts

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

  The manual order and delivery discounts to set for the targeted billing cycle. Replaces all existing manual discounts.

  * To update an existing discount within the new set, include its `id`.
  * To add a new discount, omit its `id`.
  * To remove all manual discounts, provide an empty array (`[]`).

* note

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

  The note for the targeted billing cycle. To remove the existing note, pass `null`.

* with​Merchandise​Customizations

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

  non-null

  Specifies whether to use merchandise customizations in the calculation.

***

## Mutations using this input

* [subscription​Billing​Cycle​Contract​Edit​Calculate.billingCycleEditInput](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleContractEditCalculate#arguments-billingCycleEditInput)

  ARGUMENT

***

## Map

### Mutations using this input

* [subscription​Billing​Cycle​Contract​Edit​Calculate.billingCycleEditInput](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleContractEditCalculate#arguments-billingCycleEditInput)