---
title: >-
  New options for app subscription upgrades and downgrades - 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/new-options-for-app-subscription-upgrades-and-downgrades
  md: >-
    https://shopify.dev/changelog/new-options-for-app-subscription-upgrades-and-downgrades.md
metadata:
  effectiveApiVersion: 2022-07
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2022-06-09T16:21:43-04:00'
  postedAt: '2022-06-13T00:00:00-04:00'
  updatedAt: '2024-12-13T17:24:34-05:00'
  effectiveAt: '2022-06-13T00:00:00-04:00'
---

June 13, 2022

Tags:

* API
* 2022-07

# New options for app subscription upgrades and downgrades

As of GraphQL Admin API version 2022-07, app developers can now choose their preferred update behavior when upgrading or downgrading merchant application subscriptions.

By specifying the desired `AppSubscriptionReplacementBehavior` type, app developers can control whether the new subscription goes into effect immediately or is deferred to the end of the current subscription's billing cycle. By default, all app subscription changes will continue with the existing behavior.

Learn more about specifying app subscription replacement behavior on [Shopify.dev](https://shopify.dev/api/admin-graphql/unstable/enums/AppSubscriptionReplacementBehavior).