Shopify API versions and support dates
Shopify releases a new API version every quarter and supports each stable version for at least 12 months.
Source: Shopify API versioning · last checked 13 Oct 2026
| Version | Released | Supported until | Status |
|---|---|---|---|
| 2027-01 | 1 Jan 2027 | 16 Jan 2028452 days left | Release candidate |
| 2026-10 | 1 Oct 2026 | 16 Oct 2027360 days left | Latest stable |
| 2026-07 | 1 Jul 2026 | 16 Jul 2027268 days left | Stable |
| 2026-04 | 1 Apr 2026 | 16 Apr 2027177 days left | Stable |
| 2026-01 | 1 Jan 2026 | 16 Jan 202787 days left | Support ending soon |
| 2025-10 | 1 Oct 2025 | 16 Oct 2026 | Unsupported |
| 2025-07 | 1 Jul 2025 | 16 Jul 2026 | Unsupported |
| 2025-04 | 1 Apr 2025 | 16 Apr 2026 | Unsupported |
Shopify releases each version at 17:00 UTC on its release date, and a version stops being accessible at 15:00 UTC on its support end date.
Stable, release candidate and unstable
- Stable versions are for production. Each one doesn't change for as long as it's supported: at least 12 months, with at least nine months of overlap between one version and the next.
- The release candidate comes out on the same day as a stable version and becomes the next stable version three months later. It can still change in ways that break things, so test against it but don't ship on it.
- Unstable changes all the time and holds work in progress that may never be released. Use it for early testing only.
What happens when a version retires
A request for a version that is no longer accessible doesn't fail: Shopify answers it with the oldest stable version still supported. That version may already be missing fields your app relies on, so a retirement can break an app that never changed its code. Apps that keep using removed features after Shopify's deadline can be delisted from the Shopify App Store.
How to check which version you're getting
Every API response carries an X-Shopify-API-Version header with the version that actually answered it, and webhooks carry the same header. If it differs from the version in your request URL, your app is asking for a version that has retired.
Planning an upgrade
- Always put a version in your requests, never rely on the default.
- Each quarter, read the new version's release notes and check the deprecation tracker for anything removed in it.
- Test against the release candidate, then move to the new stable version well before the one you use reaches its support end date.
- After upgrading, confirm the response header shows the version you asked for.
Not every Shopify API is versioned. Liquid, the Ajax API, the Web Pixels API and some others can change at any time, so they follow the changelog rather than this calendar.