App shows "Unsupported" badge in Shopify Admin despite clean API health report

GraphQL Admin API Troubleshooting
1

Hi all,

We’re seeing our app marked with an “Unsupported” badge under Settings → Apps and sales channels for a subset of merchants. The app detail page shows:

“This app may not work as expected. [APP NAME] needs to be updated by the app developer. Contact them for support or uninstall the app.”

Reports started roughly after the 2025-07 API version reached its Accessible until date (July 16, 2026 15:00 UTC, per the versioning docs).

What’s confusing us: our Partner Dashboard’s own “API health” monitoring (Monitoring → API health) shows “OK, no calls with breaking changes detected in the last [14/30] days”, which seems to directly contradict the Unsupported designation.

What we’ve verified ourselves so far:

  • We do have some GraphQL Admin API calls pinned to 2025-07. Hitting that version directly confirms it falls forward silently, response comes back served by 2025-10 (x-shopify-api-version: 2025-10), with an x-shopify-api-version-warning header attached.
  • We ran introspection against every field our 2025-07-pinned queries actually touch (Market, ProductVariant, Product, Location, InventoryLevel, etc.) and found nothing marked isDeprecated.
  • GET /admin/api/[VERSION]/deprecated_api_calls.json returned {"errors":"Not found"} for our test shop (that we’re seeing the ‘Unsupported’ badge for, unclear if that’s because the resource doesn’t apply to public (non-custom) apps, or something else.

Questions for Shopify staff or anyone who’s hit this:

  1. What specific condition sets the “Unsupported” badge, is it purely “still requesting a version past its accessible-until date,” regardless of whether calls are actually falling forward without error?
  2. Why would this show as “OK” in API health monitoring while the app itself is flagged Unsupported, are these two genuinely separate systems?
  3. Has anyone else seen a wave of this start around the 2025-07 retirement window?

Relevant screenshots attached below.

image
image2476×702 43.5 KB

Screenshot 2026-07-17 at 3.20.35 AM
Screenshot 2026-07-17 at 3.20.35 AM1252×712 48.5 KB

2

They’ve been doing this for several years. It’s nothing but a headache. We get emails from merchants every now and then asking if the app is still supported when it is. Worst case we’re using a deprecated but still SUPPORTED API version.

It really needs to stop. It does nothing but lie to merchants and cause confusion.

3

Oh and I have also seen this occur randomly within 30 days after we made an API upgrade that previously showed as deprecated. There’s an old post or two on here about it.

4

Facing the same issue. Everything looks clean in the dev dashboard

5

We are also facing the same issue, any update?

6

We have the same problem with one of our apps.

7

Quick update: the badge has now disappeared for us.

We updated everything we could to 2026-01, including the Admin GraphQL API, Storefront API, and all extension versions. After that, the warning was removed.

The slightly funny part is that our dashboard showed no deprecated API calls, no calls with breaking changes, and no related errors or emails from Shopify. So the fix was somewhat of a guessing game, but hopefully this helps anyone seeing the same issue.

It would be very helpful if Shopify could show the exact API call, extension, or version triggering the warning in the future. That would make resolving cases like this much easier.