API sunsets · Shopify · checked
Shopify Storefront API 2025-07 unsupported on 16 July 2026
Shopify Storefront API 2025-07 became unsupported on 16 July 2026 at 15:00 UTC. Since then, requests fall forward to the oldest supported version, with no error; fields and types removed since then stop coming back; and public apps still calling unsupported resources are delisted from the App Store. The failure is silent: calls still succeed, answered by another version, and no error says so. Shopify names 2026-10 as the replacement (the latest stable version on 8 October 2026). The date has passed, so 2025-07 can no longer be recorded as it was; compare the responses you still have with what 2026-10 returns. Find every place your code pins 2025-07: npx --allow-git=root github:agentwares/api-sunset scan
$ npx --allow-git=root github:agentwares/api-sunset scan
npx --allow-git=root github:agentwares/api-sunset scan lists every API version your code and config pin (Shopify, Meta Graph, Google Ads, HubSpot, Stripe and the rest of this list) with its end date, what breaks and this page's link. It needs no account and no API key, reads your files on your machine and sends nothing; its one request fetches this data. Free and MIT licensed.
The facts
- API
- Shopify Storefront APICovers the Storefront API.
- Version
2025-07Released 1 July 2025.- Ended
- 16 July 2026 at 15:00 UTC
- After the date
- falls forward, app delisting
- Silent?
- Yes: no error is returned
- Answered by
2025-10The oldest version still usable on 9 October 2026; on the day after the date it was2025-10.- Replacement
2026-10the latest stable version on 8 October 2026
What breaks after 16 Jul 2026
- If your app targets an inaccessible version, Shopify falls forward and responds using the oldest accessible stable version. The X-Shopify-API-Version response header names the version that answered; it is the only sign. source
- Deprecated fields or types are removed in a subsequent release, so the newer version that answers in its place may no longer have fields your code reads. source
- If your app continues to use unsupported resources after the upgrade deadline, it's delisted from the Shopify App Store: users are blocked from installing it for at least seven days and see warnings in the Shopify admin. source
- The Storefront API takes the version in its URL: /api/<version>/graphql.json; Hydrogen and the Storefront API client set it as storefrontApiVersion or apiVersion.
How to upgrade
- Find every place your code and config pin 2025-07:
npx --allow-git=root github:agentwares/api-sunset scanprints each file and line, and the variable name for a.envfile, never its value. - Read what changed between 2025-07 and
2026-10in Shopify's notes, and list the calls that touch it. - 2025-07 no longer answers as it did, so compare the responses you logged before 16 July 2026 with what 2026-10 returns now.
- Change the version string, deploy, and watch the first day's responses.
Record your real calls on the old version before the date, and replay them on the new one.
agentcheck runs scheduled checks of an endpoint. A check sends the request you define (a path or a full URL, a method and a body, with your API key as a header, stored encrypted) on a schedule and compares each response with a golden: exact text, contains, a regular expression or a JSON Schema, none of which costs an LLM call. When a response stops matching, it opens an incident and alerts you. Point one check at 2025-07 and one at 2026-10 with the same golden, and you see which of your calls answer differently before 16 July 2026.
Free: 1 monitored target, hourly checks, badge and public status page. Starter: 3 targets, 5-minute checks, Slack and Discord alerts, 30-day history. Recording the calls your code already makes is a different path: the trace import (POST /api/v1/targets/{id}/traces, or the agentcheck_record MCP tool) takes agent traces, a prompt and an answer, and turns them into checks judged by the LLM judge (Pro). It does not take raw HTTP requests and responses, so for an API the scheduled checks are the way in today.
Migration watch is not built. It would record the calls your code makes to Shopify Storefront API 2025-07 and replay them on 2026-10 until 16 July 2026, with nothing to set up, and email you what answers differently. If you would pay for that, say so with one click. The click is counted; nothing else is sent or stored.
Counted. Thank you; nothing else was sent.Also ending on 16 July 2026
Other Shopify dates
- Shopify Admin API 2025-10 — 16 Oct 2026
- Shopify Storefront API 2025-10 — 16 Oct 2026
- Shopify Admin API 2026-01 — 16 Jan 2027
- Shopify Storefront API 2026-01 — 16 Jan 2027
- Shopify Admin API 2026-04 — 16 Apr 2027
- Shopify Storefront API 2026-04 — 16 Apr 2027
Sources
- About Shopify API versioning — the date and the replacement, read 8 Oct 2026
Built only from Shopify's own pages. No intent is implied: a date is what the page says on the day it was read. Data: /apis/sunsets.json.
api-sunset is a free tool from agentcheck, which runs scheduled checks of your endpoints and alerts you when an answer changes.