---
title: >-
  Subscriptions Contracts APIs - Deprecate subscriptionContract stale status -
  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/subscriptions-contracts-apis-deprecate-subscriptioncontract-stale-status
  md: >-
    https://shopify.dev/changelog/subscriptions-contracts-apis-deprecate-subscriptioncontract-stale-status.md
metadata:
  effectiveApiVersion: 2024-01
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation Announcement
    handle: deprecation
  indicatesActionRequired: true
  createdAt: '2023-11-07T14:00:34-05:00'
  postedAt: '2024-01-01T00:00:00-05:00'
  updatedAt: '2024-12-13T17:24:40-05:00'
  effectiveAt: '2024-01-01T00:00:00-05:00'
---

[Back to Developer changelog](https://shopify.dev/changelog)

January 1, 2024

Tags:

* Action Required
* API
* 2024-01

# Subscriptions Contracts APIs - Deprecate subscriptionContract `stale` status

As of Admin GraphQL 2024-01, the[ `SubscriptionContractSubscriptionStatus.STALE` status](https://shopify.dev/docs/api/admin-graphql/2023-10/enums/SubscriptionContractSubscriptionStatus#value-stale) is being deprecated. Instead, please use `EXPIRED` or `CANCELLED`.

Any existing contracts with the `STALE` status will be returned as `CANCELLED`.

Additionally, we are now preventing the update of Subscription Contracts to have the `STALE` status.