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:
- API
- 2024-01
Metaobjects exposed as market localizableRead full post –>As of 2024-01 Metaobjects will be exposed as a MarketLocalizableResourceType. This means that...
Tags:
- API
- 2024-01
OrderTransaction now exposes the multiCapturable fieldRead full post –>As of
2024-01theendpoint now exposes thefield, to inform whether a transaction can be captured multiple times.Learn more about...
Tags:
- API
- 2024-01
Expose line_item field on AbandonedCheckout GraphQL API to publicRead full post –>As of 2024-01, the
field onGraphQL API will be available to public.Tags:
- Action Required
- API
- 2024-01
Improved support for syncing external marketing activities and receiving aggregate marketing dataRead full post –>The 2024-01 GraphQL Admin API update renames fields, requires new inputs, and deprecates others. It adds bulk operations, supports external activity sync, and enhances data deletion and aggregation.
Tags:
- Action Required
- API
- 2024-01
Removal of accepts marketing fields in Admin API customer resourcesRead full post –>API 2024-01 removes
,, and. Useinstead for customer data handling.Tags:
- API
Discounts API - New fixed amount option for Buy X Get Y discountRead full post –>Buy X Get Y discounts now support fixed amount discounts, usable with percentage/free item options. Available as automatic or code via Discounts GraphQL API.
Tags:
- API
- 2024-01
Delete multiple market regions in a single mutationRead full post –>As of API version 2024-01, you can use the
mutation to delete multiple market regions in a single mutation.Learn more about markets on...
Tags:
- API
Add, remove, and update discounts with the newest order editing APIRead full post –>You can now add, remove, and update discounts on existing order items using new mutations, enhancing flexibility in order edits for developers.
Tags:
- API
created_by_app and created_by_user fields on Metaobject and MetaobjectDefinition typesRead full post –>New fields
andadded toandMetaobject.inMetaobjectdeprecated; useinstead.Tags:
- API
- 2024-01
Update storefront access control settings in custom dataRead full post –>API 2024-01 updates access controls for custom data, affecting reserved prefixes and app settings. Developers can configure access for admin and storefront, impacting data visibility and permissions.
Tags:
- API
- 2024-01
Order Cancellation now available on GraphQL Admin APIRead full post –>GraphQL Admin API 2024-01 adds orderCancel mutation for async order cancellation with options for refund, restock, notifications, and notes. Track status via the job API.
Tags:
- API
"Awaiting return items" fulfillment hold reasonRead full post –>AWAITING_RETURN_ITEMSThe fulfillment hold is applied because of return items not yet received during an exchange.The new hold reason is applied to a [fulfillment...
Tags:
- API
- 2024-01
Updates to Split and Merge FeatureRead full post –>API Version 2024-01 introduces webhooks for Split/Merge, adds line item connections to FulfillmentOrderLocationForMove, and a new error code for missing line items in Split.
Tags:
- API
- 2024-01
Enhanced the FulfillmentOrder API with additional Order details and FulfillmentOrderLineItem with financialSummariesRead full post –>API v2024-01 adds
,,,toandto, enhancing order and financial data access.Tags:
- API
- 2024-01
New webhook topics added for Metaobject eventsRead full post –>As of API version 2024-01 of the GraphQL Admin API, your app can subscribe to
,and.These new webhook topics use sub-topics so you...
Tags:
- API
- 2024-01
Subscriptions Contracts APIs: Introduce new mutations to update Subscription Contract statusRead full post –>The 2024-01 GraphQL Admin and Customer API release allows single-operation updates to subscription status with new mutations like Activate, Pause, Cancel, Fail, and Expire.
Tags:
- API
- 2024-01
Subscriptions Billing Cycles APIs: Introduce new mutations to update SubscriptionBillingCycle skipped fieldRead full post –>As of the 2024-01 release of the GraphQL Admin API and GraphQL Customer API, you can update the skipped field of a subscription billing cycle in a single operation with the...
Tags:
- API
- 2024-01
Webhook topics introduced for updating subscription contract statusRead full post –>The 2024-01 GraphQL Admin API release adds webhook topics for subscription status changes: activate, expire, fail, cancel, and pause, enhancing real-time contract status tracking.
Tags:
- Action Required
- API
- 2024-01
Subscriptions Contracts APIs - Deprecate subscriptionContractstalestatusRead full post –>As of Admin GraphQL 2024-01, the
status...Tags:
- API
- 2024-01
Subscriptions Contracts APIs: Introduce SubscriptionContractFetchDeliveryOptions and SubscriptionContractSelectDeliveryMethod mutationsRead full post –>As of the 2024-01 release of the GraphQL Customer API, you can fetch the available delivery options for a subscription contract with
. And you can...Tags:
- Action Required
- API
- 2024-01
Subscription Billing Attempt is now prevented if a subscription contract has terminal statusRead full post –>The 2024-01 GraphQL Admin API update blocks
for terminal statuses and addsCONTRACT_TERMINATEDerror code to handle blocked attempts.Tags:
- API
- 2023-04
Product type is now translatableRead full post –>Using the TranslationsRegister GraphQL API, you can now register translations for Product types.
Product type...
Tags:
- API
- 2024-01
Metaobject Pages now available in Storefront MenusRead full post –>API 2024-01 allows adding Metaobject page links to Storefront menus. Only Metaobjects with
Renderableandcapabilities can be used for Online Store URLs.Tags:
- API
- 2024-04
Optional Address Validation in Storefront APIRead full post –>The 2024-04 Storefront API release adds
for cart mutations, enabling strict or country-only address validation, impacting error handling and address storage.Tags:
- Themes
Theme editor now supports metaobject references in text settingsRead full post –>Theme editor's richtext, text, and inline_text now support metaobject references. Liquid filters metafield_tag and metafield_text updated for dynamic sources, enhancing product detail customization.
Tags:
- Admin GraphQL API
- 2024-01
Filter price list prices by product and variant IDsRead full post –>As of the
2024-01version of the Admin GraphQL API, you can filter thepricesconnection on [Price...Tags:
- Tools
Modal API added to the latest version of App BridgeRead full post –>With the latest version of App Bridge, you can use the modal API with custom DOM content.
You can also use the new max modal...
Tags:
- API
- 2024-01
General availability of Shipping Discount Function APIRead full post –>API Version 2024-01 introduces the Shipping Discount Function API for all merchants. Deprecated:
inand.Tags:
- API
- 2024-01
InventoryQuantityGraphQL object now has a globally-unique ID in Admin APIRead full post –>As of GraphQL Admin API version 2024-01 , you can use the
IDfield to identify an...Tags:
- Shopify App Store
Customer Accounts Extensibility is now available in Developer PreviewRead full post –>Partners can now build extensions for new customer account pages, enhancing order actions and profiles, in developer preview, improving user experience with seamless app navigation.
Tags:
- Action Required
- API
- 2023-10
UI Extensions - Shipping method option list targets will be duplicated for possible types of delivery groups (One Time Purchases and Subscription)Read full post –>UI extensions using
won't render for mixed purchases. Usefor delivery groups. NewID added.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:
- 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
- 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:
- 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
AUTHORIZEDstatus, 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...