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
New and updated operations for the Cart Transform APIRead full post –>The 2024-01 Cart Transform API adds fixed pricing, custom titles, and images for bundles, plus an
updateoperation for Plus merchants.ensures critical function execution.Tags:
- API
- 2024-01
New optional argument to include translations when duplicating productRead full post –>As of 2024-01 version in the admin GraphQL API, you can specify whether to include translations when calling the...
Tags:
- API
- 2024-01
Reset to default functionality for Checkout Branding Admin API mutationRead full post –>Admin API 2024-01 allows
to reset branding to defaults usingnullin, simplifying the reset of branding settings and subfield groups.Tags:
- API
- 2024-01
Bugfix to Returns API: Block refunds on requested returnsRead full post –>API version 2024-01 fixes a bug allowing refunds on returns with
REQUESTEDstatus. Refunds are now blocked, ensuring accurate return processing.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:
- 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:
- 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
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
ChoiceList branding controls exposed in Checkout Branding APIRead full post –>As of Admin API 2024-01, you can use the Checkout Branding API to customize the look of the ChoiceList components on your checkout with
.Learn more about the...
Tags:
- API
- 2024-01
Adding Scheduled Changes to InventoryRead full post –>The 2024-01 update introduces Scheduled Changes for inventory, aiding planning without auto-adjustment. Use new mutation inventorySetScheduledChanges to manage these changes effectively.
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
created_by_app and created_by_user fields on Metaobject and MetaobjectDefinition typesRead full post –>New fields
andadded toandMetaobject.inMetaobjectdeprecated; useinstead.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
- 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
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
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:
- 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
- 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
Subscriptions Contracts APIs - Deprecate subscriptionContractstalestatusRead full post –>As of Admin GraphQL 2024-01, the
status...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:
- 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
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
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
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
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
"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
- 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:
- 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.