---
title: >-
  Introduce new stale status to Subscription Contracts - 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/introduce-new-stale-status-to-subscription-contracts
  md: >-
    https://shopify.dev/changelog/introduce-new-stale-status-to-subscription-contracts.md
metadata:
  effectiveApiVersion: 2023-07
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2023-03-17T16:54:47-04:00'
  postedAt: '2023-07-01T00:00:00-04:00'
  updatedAt: '2024-12-13T17:24:37-05:00'
  effectiveAt: '2023-07-01T00:00:00-04:00'
---

July 1, 2023

Tags:

* API
* 2023-07

# Introduce new `stale` status to Subscription Contracts

As of API version **2023-07,** you can use the new Subscription Contract `stale` status to express a contract that has been marked as stale due to inactivity.

We're deprecating the [SubscriptionDraftErrorCode `STALE_CONTRACT`](https://shopify.dev/docs/api/admin-graphql/2022-10/enums/subscriptiondrafterrorcode#value-stalecontract) and replace it by `CONCURRENT_CONTRACT_UPDATE` for a better description of the error.

We're introducing the new error code `CONTRACT_STALE_STATUS` to [SubscriptionBillingCycleErrorCode](https://shopify.dev/docs/api/admin-graphql/unstable/enums/SubscriptionBillingCycleErrorCode) and [SubscriptionDraftErrorCode](https://shopify.dev/docs/api/admin-graphql/unstable/enums/SubscriptionDraftErrorCode) to indicate whenever we attempt to update or bill a contract that hasn't been used for 1 year.