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.
Tags:
- Action Required
- API
Automatic Discount Functions now apply to B2B sessionsRead full post –>As of Dec 6, 2023, Shopify Functions support automatic discounts for B2B customers. Use BuyerIdentity.purchasingCompany to customize discounts. Note: Not for draft order submissions.
Tags:
- API
- 2024-01
Shopify Function to uniformly use the GraphQL scalar HandleRead full post –>As of 2024-01, fields returning a "handle" will use an appropriate
Handlescalar as their type, instead of aString. This signals that this type is not just any string, but specifically a...Tags:
- Action Required
- API
- 2024-01
Addition of LineItem current_quantity on Admin REST APIRead full post –>Migrate to using the new current_quantity field for accurate line item quantities. Recommended to switch to GraphQL. Available in Admin REST API version 2024-01.
Tags:
- API
- 2024-01
Customer Account API schema improvementsRead full post –>API version 2024-01 introduces breaking schema changes, logout redirect support, and marketing subscription mutations. Available in Developer Preview via Hydrogen and Headless channels.
Tags:
- Tools
Collaborator request code now required to initiate request for store accessRead full post –>Collaborator requests now require a unique code by default, enhancing merchant control over store access and ensuring only authorized partners can initiate requests.
Tags:
- API
Introducing webhook topics for discount eventsRead full post –>We’ve introduced dedicated webhook topics that will be sent out whenever a discount has been created, updated or deleted, enabling developers to keep their discount apps in sync.
Learn more...
Tags:
- API
- 2024-01
Introducing the new Customer Data Erasure APIRead full post –>GraphQL Admin API 2024-01 introduces Customer Data Erasure API with mutations to request or cancel customer data erasure, aiding GDPR/CCPA compliance for developers.
Tags:
- API
Shopify Functions run logs now include production store executionsRead full post –>All Shopify Functions executions are now visible for production stores in your Partner Dashboard.
Run details are only available for failed runs that...
Tags:
- Action Required
- API
- 2024-01
AppSubscriptionDiscountInput.durationLimitInIntervals will no longer accept 0Read full post –>As of Admin API 2024-01, AppSubscriptionDiscountInput.durationLimitInIntervals will no longer accept 0. To create a discount with an unlimited duration, durationLimitInIntervals should not be...
Tags:
- Tools
[Developer preview] Checkout Kit for AndroidRead full post –>Shopify's Checkout Kit for Android offers a customizable, one-page checkout with store customizations and APIs, supporting light/dark modes. Now in Developer Preview.
Tags:
- API
- 2024-01
Breaking changes to Variants API: Removal of "ProductVariantsBulkInput.imageId" and "ProductVariantsBulkInput.imageSrc"Read full post –>In GraphQL Admin API 2024-01,
andare removed from. Useandinstead for product variant media handling.Tags:
- Platform
UI extensions on the Thank you and Order status pages have launchedRead full post –>Checkout Extensibility now allows plus merchants code-free customizations on Thank you and Order status pages, replacing deprecated checkout.liquid and scripts by 2025.
Tags:
- API
Storefront APICart.checkoutUrlnow contains key paramRead full post –>Storefront API Cart now includes a
keyparam infor buyer info. Update apps constructing URLs to useand ensure additional params don't override it.Tags:
- Themes
Theme Store Full-funnel Google Analytics attributionRead full post –>Google Analytics integration now tracks theme installs with Shop ID, offering deeper insights into merchant types.
Tags:
- Shopify App Store
Introduce subscriptions contracts cleanup mechanismRead full post –>A new cleanup process auto-cancels unterminated Subscription Contracts 48 hours post-app uninstall, affecting
active,paused, orfailedstatuses.Tags:
- API
[Developer Preview] Cart Transform API - Updating lines in the cartRead full post –>The Cart Transform API now allows
updateoperations to override price, title, and image of cart items, enhancing customization flexibility for developers.Tags:
- Platform
- 2023-10
Hydrogen 2023.10 has been releasedRead full post –>Hydrogen v2023.10 introduces Remix 2.0, updates caching, and requires GraphQL type changes. New API client added; deprecated props removed. Custom cart methods are stable.
Tags:
- Action Required
- API
- 2023-10
Changes to Point of Sales (POS) payment processing behaviorRead full post –>POS payment processing changes: Orders can be canceled within 15 mins. Admin API shows
status, separateobjects; Storefront API mirrors Admin behavior.Tags:
- API
- 2024-01
Breaking changes to Products API: Deprecate "ProductInput.images"Read full post –>As of GraphQL Admin API version 2024-01, we're deprecating the
imagesfield from theinput object and replacing it with amediaargument in the...Tags:
- API
- 2023-10
UI extensions - the order status page is getting a new lookRead full post –>The order status page gets a new look, aligning with customer accounts. Rolled out progressively, no action needed. UI extensions remain unchanged.
Tags:
- API
New fields on Country Liquid objectRead full post –>Added
,continent, andpopular?to Liquid'scountryobject, enhancing localization and sorting in country selectors for improved theme flexibility.Tags:
- Tools
[Developer Preview] Mobile Checkout SDK for iOSRead full post –>Shopify launches iOS Mobile Checkout SDK Developer Preview. Offers customizable, high-conversion checkout with store customizations. Android SDK coming soon. APIs may change with feedback.
Tags:
- API
[Developer Preview] Cart Transform API - Pricing bundles per component & additional customizationsRead full post –>The Cart Transform API now supports fixed prices and custom titles/images for bundle components, enhancing control over bundle pricing and enabling add-on product bundles.
Tags:
- Shopify App Store
Display Business Imprint on Shopify's App Store and Theme StoreRead full post –>Starting October 11, 2023, Shopify's App Store and Theme Store will display the partner's geographical address and contact information in order to be in compliance with Business Imprint legal...
Tags:
- Shopify App Store
App Store listings are now automatically translated into 8 languagesRead full post –>English app listings are now auto-translated into 8 languages, boosting non-English market installs by 20%. Developers can enhance this by translating their app's UI.
Tags:
- Platform
Shopify Flow - Use dev command to preview tasks and use more complex data in triggersRead full post –>The
devcommand now supports Flow extensions, enabling complex data in triggers. Flow in CLI is generally available, requiring CLI v3.48+ anddevv3.49+ for full functionality.Tags:
- API
Shopify Functions now support localization of their name and descriptionRead full post –>Shopify Functions now support localization for names and descriptions, allowing translation into users' native languages. Upgrade Shopify CLI to 3.49.5+ to use this feature.
Tags:
- API
- 2023-10
Shopify Function configurations now use target identifiersRead full post –>API v2023-10 and Shopify CLI 3.49.5 introduce
targetingfor Shopify Functions, aligning them with app extensions. Upgrade CLI to 3.49.4+ to usetargeting. Existing functions remain unaffected.Tags:
- API
- 2023-10
New fields available for Shopify Functions input queriesRead full post –>API v2023-10 adds
shop,localization, andfields to Shopify Functions, enhancing access to shop data, localization, and currency rates for developers.Tags:
- API
- 2023-10
Updates to GraphQL Admin API for bundlesRead full post –>As of 2023-10, query
forto identify bundle variants. Apps can render custom UI on product pages by claiming bundle ownership.Tags:
- API
- 2023-10
New webhook topic added for Publication delete eventsRead full post –>As of API version 2023-10, a new webhook topic
is added. This webhook occurs whenever a publication is deleted and requires thescope.Tags:
- Action Required
- API
- 2023-10
Removal of Customer averageOrderAmount fields on Admin APIRead full post –>As of GraphQL Admin API version 2023-10, the following
Customerfields have been deprecated:,.Learn more about the
Customerobject on...Tags:
- Action Required
- API
- 2023-10
Deprecation ofmetafield(id)queryRead full post –>As of 2023-10, the
metafield(id)query is no longer supported. Metafields should be queried via theconnection of metafield owners. If necessary, metafields can be queried by ID...Tags:
- API
- 2024-01
Subscriptions Support for Automatic DiscountsRead full post –>Added subscription options for automatic product discounts. From 2024-01, API will classify these as "AUTOMATIC_DISCOUNT" instead of "MANUAL".
Tags:
- API
- 2023-10
New field to query Order cancellationRead full post –>As of 2023-10, we've added a new field
cancellationtoOrdergraphQL object.This field can provide additional details about the order cancellation, such as staff provided notes on why the...
Tags:
- Action Required
- API
- 2023-10
Simplify Metafield interaction with default namespacesRead full post –>From 2023-10, the Admin and Storefront GraphQL APIs make the namespace field optional for Metafields, simplifying app interactions by using a default namespace when unspecified.
Tags:
- API
- 2023-10
Manage Quantity Price Breaks for B2B CustomersRead full post –>As of the
2023-10version of the Admin GraphQL API, you can view thefor a product variant onand. Additionally, you will...Tags:
- Action Required
- API
- 2023-10
Making the primary market more flexibleRead full post –>As of 2023-10, you can customize the primary market in three new ways:
- The currency can be set to any currency independent of the merchant's shop currency.
- The country can be set...
Tags:
- Action Required
- API
- 2023-10
Apps can now change the name and address of their fulfillment service locationsRead full post –>In API 2023-10, apps can edit fulfillment service location names/addresses via LocationEdit. New errors: modifying fulfillsOnlineOrders is restricted; write_fulfillments scope is needed for edits.
Tags:
- API
- 2023-10
Cart Line Items Now Ordered in Reverse Chronological Order Based on Time of AdditionRead full post –>API v2023-10 changes cart item order: new items now appear at the top. Developers should check app functionality if it depends on item order in the cart.
Tags:
- API
- 2023-10
New error code added for MetafieldDefinitionUpdateRead full post –>API v2023-10 introduces
error for updatingdefinitions, replacing, improving error specificity.Tags:
- Action Required
- API
- 2023-10
Breaking change to metafieldDefinitionUpdate mutation: access input type changedRead full post –>GraphQL Admin API 2023-10 changes
type to, impacting apps usingfor access property updates.Tags:
- API
- 2023-10
payment_method_nameavailable in PaymentDetails GraphQL and REST APIs to check for Shop Pay Installments transactionsRead full post –>The
field is added to PaymentDetails GraphQL and Admin REST APIs for identifying Shop Pay Installments, replacing reliance ongatewayvalues starting January 2024.Tags:
- API
Checkout branding is moving to stable, with an update on color settingsRead full post –>The Checkout Branding API now allows more color control. Use
instead of the deprecatedfor future updates.Tags:
- Action Required
- Shopify App Store
App Revenue Attribution Record API DepreciatedRead full post –>The App Revenue Attribution API is removed. Methods for creating and deleting records are unsupported. Use Google Analytics for tracking Shopify App Store Ads installs and related metrics.
Tags:
- API
- 2023-10
Introducing explicit access grants for app-owned metafieldsRead full post –>GraphQL Admin API 2023-10 adds
grantsfor/metafield access, allowing up to 16 grants per definition. Note breaking change in.Tags:
- API
- 2023-10
serviceCode is available on the DeliveryMethod APIRead full post –>As of the { 2023-10 } API version, you can use { DeliveryMethod } to get the value of the { serviceCode } chosen for the related { FulfillmentOrder} . The { DeliveryMethod } object is now...
Tags:
- API
- 2023-10
More information about the Order added to the FulfillmentOrder APIRead full post –>New fields
,,,added toobject. Access order data with fulfillment_orders scope, no read_orders scope needed.Tags:
- Action Required
- API
- 2023-10
Multiple domains on the primary marketRead full post –>API v2023-10: Markets API now supports multiple domains. New
added. Usefor updates/deletes. Add domains with.Tags:
- Action Required
- API
- 2023-10
RemovingShop.shopifyPaymentsAccounton Admin APIRead full post –>As of
2023-10, we're removing the deprecatedfield. Use the...