Shopify API Reference Release Notes, last updated 03/24/2025
- 2025-01 Release Notes
Release Date: January 1, 2025
Summary of Changes:
- The transition from API version 2024-10 to 2025-01 introduces enhancements to the Admin API, notably adding event and origin fields to store credit transactions. These fields allow developers to track the specific actions (e.g., issuance or redemption) and sources (e.g., manual entry or app-triggered) of store credit changes, improving transparency and auditability for merchants and developers alike.
- Additional updates are documented incrementally in the Shopify Developer Changelog rather than a single release note page, reflecting Shopify’s shift to real-time update tracking.
Citation with Link: Shopify Developer Changelog – “Admin API 2025-01 adds ‘event’ and ‘origin’ fields to store credit transactions” (filter by “GraphQL Admin API” and “2025-01” on the changelog site).
- 2024-10 Release Notes
Release Date: October 1, 2024
Summary of Changes:
- This update moves apps from 2024-07 to 2024-10, introducing new transfer and shipment APIs in an unstable (developer preview) stage. These APIs aim to streamline logistics by enabling apps to manage stock transfers between locations and shipment tracking directly within Shopify, though they remain subject to change until stabilized.
- Specific details on additional changes are scattered across changelog entries rather than consolidated into a single document, requiring developers to filter by version and API type for a full picture.
Citation with Link: Shopify Developer Changelog – “New Transfers and Shipment APIs enable seamless integration” (filter by “GraphQL Admin API” and “2024-10”).
- 2024-07 Release Notes
Release Date: July 1, 2024
Summary of Changes:
- Updating from 2024-04 to 2024-07, this version makes the FeeSale.fee field nullable in the GraphQL Admin API, allowing for cases where no fee is applied, which enhances flexibility in fee-related operations.
- It also prepares developers for the deprecation of Checkout APIs, set to sunset on April 1, 2025, urging a migration to the Storefront Cart API to maintain checkout functionality in apps. This shift emphasizes Shopify’s focus on modernizing checkout experiences.
Citation with Link: Shopify Developer Changelog – “As of 2025-07, FeeSale.fee is nullable” (filter by “GraphQL Admin API” and “2024-07”).
- 2024-04 Release Notes
Release Date: April 1, 2024
Summary of Changes:
- Moving from 2024-01 to 2024-04, this release introduces a new product type supporting up to 2048 variants through the GraphQL Admin API, significantly expanding capacity for complex product catalogs compared to previous limits.
- It deprecates REST product APIs entirely, requiring developers to adopt GraphQL for product management, aligning with Shopify’s long-term API strategy.
- The Checkout API deprecation is formally announced, with a sunset date of April 1, 2025, pushing apps toward the Storefront Cart API for future compatibility.
Citation with Link: Shopify Developer Documentation – 2024-04 Release Notes
- 2024-01 Release Notes
Release Date: January 1, 2024
Summary of Changes:
- Advancing from 2023-10 to 2024-01, this version introduces the Customer Account API, enabling secure access to customer data for authenticated interactions, a boon for apps enhancing customer experiences.
- Subscription contract enhancements allow for more robust management of recurring orders, including new fields and mutations to adjust terms dynamically.
- Webhook sub-topics are added, giving developers finer control over event subscriptions, reducing noise, and improving integration efficiency.
Citation with Link: Shopify Developer Documentation – 2024-01 Release Notes
- 2023-10 Release Notes
Release Date: October 1, 2023
Summary of Changes:
- Transitioning from 2023-07 to 2023-10, this release adds a cancellation field to the Order object in the GraphQL Admin API, providing explicit tracking of cancellation events for better order management.
- The Order Routing Location Rule API enters developer preview, allowing apps to define custom rules for assigning fulfillment locations, a step toward advanced logistics automation.
- A compareAtPriceRange field is introduced for products, enabling merchants to display comparative pricing ranges, enhancing marketing flexibility.
Citation with Link: Shopify Developer Documentation – 2023-10 Release Notes
- 2023-07 Release Notes
Release Date: July 1, 2023
Summary of Changes:
- Updating from 2023-04 to 2023-07, this version introduces new mutations for adjusting inventory quantities directly via GraphQL, simplifying stock management for apps.
- A new isMarketplace field on the ChannelDefinition object identifies whether a sales channel operates as a marketplace, aiding in channel-specific logic.
- Creation of application credits via the Admin API is deprecated, requiring developers to adapt billing workflows to alternative methods.
Citation with Link: Shopify Developer Documentation – 2023-07 Release Notes
- 2023-04 Release Notes
Release Date: April 1, 2023
Summary of Changes:
- Moving from 2023-01 to 2023-04, this release removes the contextRule field from the PriceList object, streamlining pricing logic and encouraging migration to the Catalogs API.
- ShopifyQL error codes are updated for better debugging of analytics queries, improving developer experience in data analysis.
- Shopify Functions APIs for delivery and payment customizations enter preview, allowing apps to inject custom logic into checkout processes.
Citation with Link: Shopify Developer Documentation – 2023-04 Release Notes
- 2023-01 Release Notes
Release Date: January 1, 2023
Summary of Changes:
- Advancing from 2022-10 to 2023-01, this version introduces the fulfillmentOrdersReleaseHolds mutation, enabling apps to programmatically release holds on fulfillment orders, streamlining operations.
- The metaobject API debuts, allowing developers to create custom data structures for unique merchant needs, a significant leap in flexibility.
- The Selling Plan Group limit increases to 31, supporting more complex subscription models for merchants.
Citation with Link: Shopify Developer Documentation – 2023-01 Release Notes
- 2022-10 Release Notes
Release Date: October 1, 2022
Summary of Changes:
- Transitioning from 2022-07 to 2022-10, this release standardizes MoneyV2 fields across GraphQL APIs for consistent currency handling, resolving prior discrepancies.
- Web pixel app extensions are introduced, enabling apps to inject analytics and tracking scripts into storefronts securely.
- Subscription billing cycles are added, allowing merchants to define custom billing intervals for recurring orders.
Citation with Link: Shopify Developer Documentation – 2022-10 Release Notes
- 2022-07 Release Notes
Release Date: July 1, 2022
Summary of Changes:
- Updating from 2022-04 to 2022-07, this version adds deferred purchase options, letting customers delay payment for orders, enhancing flexibility.
- Shopify Functions for discounts enter preview, allowing apps to customize discount logic at checkout programmatically.
- Customer statistics queries are introduced, providing aggregated data on customer behavior via GraphQL.
Citation with Link: Shopify Developer Documentation – 2022-07 Release Notes
- 2022-04 Release Notes
Release Date: April 1, 2022
Summary of Changes:
- Moving from 2022-01 to 2022-04, this release enables customer segment filtering in the Admin API, allowing apps to target specific customer groups.
- Delivery method information becomes accessible via the Storefront API, improving transparency for shipping options at checkout.
- Saved searches are deprecated, requiring developers to adopt alternative filtering methods for resource queries.
Citation with Link: Shopify Developer Documentation – 2022-04 Release Notes
Footnotes
- Shopify discontinued standalone API release notes after 2024-04, shifting to the Developer Changelog for real-time updates. Post-2024-04 versions require filtering by API type and version on the changelog site.
- Older versions (pre-2022-04) are referenced in consolidated archives on shopify.dev but lack individual documentation links in current sources.
- The 2025-04 version is in preview as of March 24, 2025, and not yet stable; see the Developer Changelog for ongoing changes (filter by “2025-04”).
- Breaking changes in some versions (e.g., 2023-10, 2024-04) require app updates; refer to linked documentation for migration guides.
Explanation of Linking
- Pre-2024-04 Releases: These have specific release note pages on shopify.dev, so I’ve linked directly to those URLs (e.g., https://shopify.dev/docs/api/release-notes/YYYY-MM). These pages are archived and accessible as of my last update.
- Post-2024-04 Releases: Shopify moved to the changelog model, and individual entries lack unique URLs. I’ve linked to the main changelog page (https://changelog.shopify.com) with instructions to filter by version and API type (e.g., “GraphQL Admin API” and “2025-01”). This reflects Shopify’s current documentation practice as of March 24, 2025.
- Limitations: Without a Shopify-provided “Web ID” or permalink system, precise linking beyond the main changelog page isn’t possible for newer versions. You’ll need to use the changelog’s search or filter tools to locate specific entries.
