Skip to main content

Custom app versioning

Like public apps, apps that are created in the Shopify admin also might require occasional updates to make sure that they stay up-to-date with our supported API versions.


Anchor to How do I know if my custom apps are affected?How do I know if my custom apps are affected?

If your custom apps are currently making deprecated calls, you will receive notifications in a few different ways.

A banner in the Apps page of the Shopify admin that warns that your custom apps and webhooks might stop working.

On your admin’s Apps page, you’ll find a banner warning you that your custom apps may stop working. To view which apps are at risk, click the View custom apps link.

A banner in the Develop Apps page of the Shopify admin that warns which of your custom apps and webhooks might stop working.

In your admin's Develop apps page, you'll find a banner that lists your custom apps that are currently making deprecated calls and the deadline for migrating these requests.

When an API is deprecated, Shopify emails the app developer of affected apps. These emails include a detailed breakdown of breaking changes that affect your app, and links to resources to help with your migration.

Anchor to Deprecated API calls endpointDeprecated API calls endpoint

App developers can use their app credentials to retrieve a detailed list of recent deprecated requests. In this list, you’ll get a detailed breakdown of each recent deprecated request, and the breaking change that directly affects that request.

Refer to the Deprecated API calls reference documentation for more details.


Was this page helpful?