Developer changelog
Subscribe to the changelog to stay up to date on recent changes to Shopify’s APIs and other developer products, as well as preview upcoming features and beta releases.
RSS UpdatesTags:
- Admin GraphQL API
- Webhook
- 2025-01
Update in orders webhook to view bundles and their componentsRead full post –>Starting with the Admin API version 2025-01, we have added the
field to the orders webhook. This field allows you to determine if a specific
is part of a...
Tags:
- Admin GraphQL API
- 2025-01
Combined Listings update mutation error improvementsRead full post –>Starting with the Admin API version 2025-01, we've introduced new error codes for the
mutation. These enhancements aim to provide clearer feedback when incorrect data is...
Tags:
- Action Required
- Shopify App Store
- Admin GraphQL API
- Admin REST API
Public apps must use new GraphQL Product APIs to be accepted in the Shopify App StoreRead full post –>Starting January 6, 2025, all new apps submitted to the Shopify App Store must use the [new GraphQL Product...
Tags:
- Action Required
- Storefront GraphQL API
- 2025-01
Cart Delivery Address ManagementRead full post –>API v2025-01 deprecates
, replacing it with
cart.delivery.addresses
. Manage addresses using new mutations.Tags:
- Action Required
- Admin GraphQL API
- 2025-01
Fulfillment Hold Access Update For Node QueriesRead full post –>Admin API 2025-01 restricts fulfillment hold access via node queries based on app scopes. Ensure correct scopes to avoid null results when fetching holds.
Tags:
- Action Required
- Payments Apps API
- 2025-01
Introduce 3DS support for verificationsRead full post –>Version 2025-01 adds 3DS challenge support for vaulting payments via
mutation. Update to handle new arguments and deprecated states.
Tags:
- Admin GraphQL API
- 2025-01
BXGY discount support for subscriptionsRead full post –>BXGY discounts now support subscriptions if X is a subscription and Y is a one-time or free item. Use GraphQL mutations to create/update discounts, specifying item types with input fields.
Tags:
- Payments Apps API
- 2025-01
Addition of 'paymentDetails' field inverificationSessionResolve
mutation.Read full post –>As of Payments Apps API version 2025-01 release, the
field will be addded to
mutation. Payment providers can now send payment details like Card...
Tags:
- Admin GraphQL API
- 2025-01
ReverseFulfillmentOrder.order field is nullable as of 2025-01Read full post –>As of 2025-01, the ReverseFulfillmentOrder.order field is nullable if the client lacks read_all_orders scope and the order is over 60 days old or missing, avoiding graphql errors.
Tags:
- Admin GraphQL API
- 2025-01
SupportDelayed
Fulfillment Status in GraphQL APIRead full post –>As of Admin API 2025-01, we have officially introduced a new fulfillment event status called
delayed
.Tags:
- Admin GraphQL API
- 2025-01
Admin access input is now optional when setting metafield definition accessRead full post –>When creating or updating a metafield definition's
access
theadmin
field is now optional. Whenadmin
is not explicitly set, it will default the same way it is when the entireaccess
field...Tags:
- Admin GraphQL API
Link any product metafields of type list.metaobject to product optionsRead full post –>Up until now, merchants had the ability to link their options to category metafields, allowing them to use these option values across similar products. This release expands that functionality to...
Tags:
- Action Required
- Webhook
- 2025-01
New customer's webhook and changes to existing customer's webhooks payloadRead full post –>As of 2025-01, customer webhooks updated: new
added,
tags
and consent fields replaced, and some fields moved to the new webhook.Tags:
- Admin GraphQL API
- 2025-01
Change to FulfillmentOrderSortKeysRead full post –>Starting in API version 2025-01, RELEVANCE will be removed as a valid value from...
Tags:
- Action Required
- Admin GraphQL API
- Admin REST API
- Webhook
- 2025-01
Apply multiple holds to a single fulfillment orderRead full post –>The 2025-01 API allows multiple holds per fulfillment order, requires unique handles, and introduces new webhooks. REST API remains limited to single holds.
Tags:
- Admin GraphQL API
- 2025-01
Enhanced variant query limits for single product queriesRead full post –>As of the 2025-01 version of the GraphQL Admin API, you can now use a limit of up to 2000 variants when running a query on a single product, such as
product
or. This...
Tags:
- Admin GraphQL API
- 2025-04
Add new requiresShippingMethod field to fulfillmentServiceCreate and fulfillmentServiceUpdate mutationsRead full post –>As of Admin API 2025-04, we have introduced a new field
on the...
Tags:
- Action Required
- Storefront GraphQL API
- 2025-01
Tax and Duties are deprecated in Storefront Cart APIRead full post –>As of API version
2025-01
, we're deprecating the tax and duty fields in Storefront API Cart. Tax and Duties are...Tags:
- Action Required
- Admin GraphQL API
- 2025-01
New validation against duplicate handles in productCreate, productUpdate, and productSet mutation inputsRead full post –>In Admin GraphQL API
2025-01
,handle
in product inputs must be unique, preventing duplicates in product creation/updates. Existing behavior unchanged ifhandle
is omitted.Tags:
- Admin GraphQL API
- Webhook
- 2025-01
Introduce atax_exempt
field associated to aCompanyLocation
Read full post –>As of Admin API 2024-10, we have introduced a concept of
in a
object for a
. This is a generic tax exemption flag for company locations outs
Tags:
- Payments Apps API
- 2025-01
Deprecate customer_payment_method_remote_credit_card_createRead full post –>The CustomerPaymentMethodRemoteCreditCardCreate mutation is deprecated and unsupported from API version 2025-01. Update your integrations accordingly.
Tags:
- Payments Apps API
- 2025-01
Adding new revocation reasons for payment methodsRead full post –>New feature: Specify revocation reasons for customer payment methods, improving management without affecting existing partners.
Tags:
- Action Required
- Shopify App Store
Updates effective December 30 to our Partner Program Agreement and API License and Terms of UseRead full post –>Review updated Partner Program and API Terms effective Dec 30, 2024. Theme Revenue Share changes Jan 1, 2025. Ensure compliance to support app growth and security.
Tags:
- Action Required
- Admin GraphQL API
- 2025-07
DeprecatedSubscriptionMailingAddress
in favor ofMailingAddress
Read full post –>The 2025-07 version of the GraphQL Admin API deprecates
. Use
for future implementations.
Tags:
- Action Required
- Shopify App Store
Updated requirement: Draft apps must not make calls to APIs that will be deprecated in 90 days or lessRead full post –>Starting January 6, 2025, draft apps that make calls to APIs that will be deprecated in 90 days or less will not be able to submit their apps for review. This is an updated requirement. Be sure to...
Tags:
- Shopify App Store
Meta Pixel events for App Listing PageRead full post –>App listing pages now support Meta Pixel events like AddToCart and ViewContent, enabling enhanced tracking and analytics for developers.
Tags:
- Themes
Meta Pixel events for Theme Listing PageRead full post –>Theme listing pages now support Meta Pixel events like AddToCart and ViewContent, enabling enhanced tracking and analytics for developers.
Tags:
- Admin GraphQL API
- 2025-01
Removal of deprecated shop fieldsRead full post –>Admin GraphQL API
2025-01
removes deprecated fields; usefor collection, customer, draft order, marketing, order, and product queries.
Tags:
- Admin GraphQL API
- 2025-01
ImprovedproductTags
,productVendors
,productTypes
Read full post –>Admin GraphQL API
2025-01
moves,
,
to
, now paginated and supporting over 250 results, enhancing data retrieval.
Tags:
- POS Extensions
- 2025-01
Print API will be available for POS ExtensionsRead full post –>As of January 20, 2025, POS UI Extensions will offer a Print API to enable document printing functionality in your point of sale extension.
Tags:
- Action Required
- Shopify App Store
Session tokens and app listings automatically checked before submitting for app reviewRead full post –>Starting January 6, 2025, we are introducing additional preliminary steps in the app review process. These steps will provide immediate compliance feedback on draft apps before they are submitted...
Tags:
- Shopify App Store
Merchants on paid trial plans no longer able to leave reviews on Shopify's App StoreRead full post –>As of December 11, 2024, merchants on any type of trial plan (including paid trials) will not be eligible to leave a review on Shopify's App Store.
Learn more about [Shopify's policy on...
Tags:
- Admin GraphQL API
- 2025-01
New inventoryPolicy argument for billing mutationsRead full post –>New 'inventoryPolicy' argument lets developers override merchant inventory settings in billing mutations, offering flexibility in managing inventory during billing attempts.
Tags:
- Admin GraphQL API
- 2025-01
NewLocalizationExtensionKeys
value for MexicoRead full post –>As of version
2025-01
of the Admin GraphQL API, we're adding a new LocalizationExtensionsKey value to support the collection shipping credentials for cross-border shipments into Mexico:...Tags:
- Admin GraphQL API
- 2025-01
New revocation reasons for payment methods for 2025-01Read full post –>As of GraphQL Admin API version 2025-01, we've added new values to the
enum to provide more granular information about payment method revocations. This...
Tags:
- Admin GraphQL API
- 2025-01
Search discountNodes by exact discount code in the GraphQL Admin APIRead full post –>As of API
2025-01
, you can use discountsNodes() to search for exact discount codes with thecode
prefix in the query argument.Tags:
- Action Required
- Admin GraphQL API
- 2025-01
Changes to ScriptTag displayScope field on Admin GraphQL APIRead full post –>Using Script Tags? Start ensuring you're targeting the ONLINE_STORE as the
.
Tags:
- Platform
Hydrogen December 2024 releaseRead full post –>Hydrogen v2024.10.1 is out today. The December 2024 Hydrogen release contains several quality-of-life...
Tags:
- Action Required
- API
- 2025-01
Product image resource in REST now returns a media image GID to streamline migration to GraphQLRead full post –>From 2025-01, the admin REST API returns a media image GID, aiding migration to GraphQL. Only affects 2025-01 API users; older versions remain unchanged. Upgrade to GraphQL recommended.
Tags:
- API
Admin action extensions now have access to picking APIsRead full post –>Admin action extensions now have access to the resource picker and picker APIs.
Tags:
- Action Required
- Admin GraphQL API
- 2025-04
Read full post –>Deprecation Notice: CalculatedOrder for committed order editsTags:
- Shopify App Store
"Get Support" buttons can now link to custom support channelsRead full post –>App developers can now configure the "Get Support" button to redirect merchants to your preferred support channel, such as a help desk, ticketing system, forum, or live chat.
Learn more about...
Tags:
- Shopify App Store
Shopify App Store Ads now offer bid suggestions for all ad typesRead full post –>All ad types on the Shopify App Store now offer bid suggestions. In addition to search ads, you’ll now see bid suggestions when creating Homepage and Category ads. Bidding within the suggested...
Tags:
- Platform
The Winter '25 Edition is liveRead full post –>Announcing 150+ updates to Shopify.
Tags:
- Shopify App Store
New customer accounts name changeRead full post –>Update references from "new" to "customer accounts" and "classic" to "legacy customer accounts" in your docs. No API/product changes. Classic accounts will be phased out eventually.
Tags:
- Built for Shopify
Updated Built for Shopify requirement for fulfillment services callback response rateRead full post –>Built for Shopify requirements about responding to callback requests for fulfillment services...
Tags:
- Tools
Introducing the Shopify Subscriptions Reference appRead full post –>Shopify released a Subscriptions Reference app to aid developers in building subscription apps, showcasing Selling Plan APIs and best practices to accelerate development.
Tags:
- Shopify App Store
New: Purchase Options UI extensions for subscriptions, pre-orders, and try-before-you-buy appsRead full post –>Developers can now build a single extension using the Purchase Options UI extensions so merchants can more easily...
Tags:
- Customer Account API
- 2025-01
Returns now supported in Customer Accounts APIRead full post –>The Customer Accounts API now supports returns, enabling partners to build return apps, query returns, and customize return experiences with new fields, mutations, and return eligibility insights.
Tags:
- Admin GraphQL API
- 2025-01
Improved billing attempt error handling for subscriptions in Selling Plan APIRead full post –>Subscription billing now respects inventory policies, preventing overselling. New processingError feature helps identify product variants causing billing errors, enhancing error diagnostics.