---
title: >-
  Subscription contract shipping requirements now sync with product variants -
  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/subscription-contract-shipping-requirements-now-sync-with-product-variants
  md: >-
    https://shopify.dev/changelog/posts/subscription-contract-shipping-requirements-now-sync-with-product-variants.md
metadata:
  effectiveApiVersion: 2025-10
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Breaking API Change
    handle: breaking-api-change
  indicatesActionRequired: false
  createdAt: '2025-06-09T14:15:42-04:00'
  postedAt: '2025-10-01T12:00:00-04:00'
  updatedAt: '2025-07-11T08:53:15-04:00'
  effectiveAt: '2025-10-01T12:00:00-04:00'
---

October 1, 2025

# Subscription contract shipping requirements now sync with product variants

DateOctober 1, 2025

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

Flags[Breaking API Change](https://shopify.dev/changelog?filter=breaking-api-change)

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)

We've improved how subscription contracts handle shipping requirements to ensure accurate tax calculations, delivery details, and order totals. These changes apply when using the [`subscriptionBillingAttemptCreate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingAttemptCreate) mutation.

### What's Changed

**Shipping requirements use latest product information**\
Subscription contracts now dynamically retrieve the "requires shipping" value from the product variant for each contract line. Previously, a static value was stored when the subscription line was added to the contract. This update ensures that shipping requirements are always current when you update your product variants. This change also applies to [`SubscriptionDraft.fields.deliveryOptions`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionDraft#field-SubscriptionDraft.fields.deliveryOptions).

**Delivery lines added only when necessary**\
If no lines in a subscription contract require shipping, then we no longer add a delivery line to the order. This prevents unnecessary shipping charges and ensures correct tax calculations.

### Impact

These changes ensure that:

* Taxes are calculated correctly based on current shipping requirements.
* Order totals reflect accurate delivery costs.
* Shipping configuration issues are caught before orders are processed.
* Subscription contracts stay in sync with your product catalog changes.