---
title: Custom app versioning
description: API Versioning reference for app users relating to custom apps.
api_name: usage
source_url:
  html: https://shopify.dev/docs/api/usage/versioning/custom-apps
  md: https://shopify.dev/docs/api/usage/versioning/custom-apps.md
---

# 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.

***

## 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.

### Banners

![A banner in the Apps page of the Shopify admin that warns that your custom apps and webhooks might stop working.](https://cdn.shopify.com/shopifycloud/shopify-dev/production/assets/assets/images/api/versioning/merchant-app-banner-Y3uHBtdj.png)

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.](https://cdn.shopify.com/shopifycloud/shopify-dev/production/assets/assets/images/api/versioning/specific-merchant-app-banner-B4c6Gqy7.png)

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.

### Emails

![](https://cdn.shopify.com/shopifycloud/shopify-dev/production/assets/assets/images/api/versioning/deprecation-email-top-atE3yIYr.png)

![](https://cdn.shopify.com/shopifycloud/shopify-dev/production/assets/assets/images/api/versioning/deprecation-email-body-BuIieuqu.png)

When an API is deprecated, Shopify emails the [app developer](https://shopify.dev/docs/api/usage/versioning/updates#update-the-contact-details-for-a-custom-app-created-in-the-shopify-admin) 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.

### Deprecated API calls endpoint

![](https://cdn.shopify.com/shopifycloud/shopify-dev/production/assets/assets/images/api/versioning/deprecation-endpoint-request-C4fkwd0s.png)

![](https://cdn.shopify.com/shopifycloud/shopify-dev/production/assets/assets/images/api/versioning/deprecation-endpoint-response-DMHfV9UM.png)

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](https://shopify.dev/docs/api/admin-rest/latest/resources/deprecated-api-calls) reference documentation for more details.

***