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
- Storefront GraphQL API
- Liquid
- 2024-10
New customer account pages now available in menus via Admin APIRead full post –>As of API version 2024-10, you can add links to the Orders, Profile, and Settings pages to navigation menus.
To learn more, refer to...
Tags:
- Customer Account API
- 2024-10
Subscription Contract fields now fully available on the Customer APIRead full post –>The 2024-10 GraphQL Customer API update adds fields for querying subscription contracts and requires new permissions for access and mutations. New connections: lines and orders.
Tags:
- Admin GraphQL API
- 2024-10
Add subscription status updates to bulkOperationRunMutationRead full post –>Subscription Status updates can now be run with the bulkOperationRunMutation.
The following mutations have been added:
*...
Tags:
- Action Required
- Admin GraphQL API
- Admin REST API
- 2024-10
Querying events through theevents
connection andCommentEvent.subject
becomes nullableRead full post –>As of 2024-10, query events via
,
event
, andevents
.events
connection added to multiple types.is now nullable;
deprecated.
Tags:
- Action Required
- Storefront GraphQL API
- 2024-10
Cart Warnings in Storefront API CartRead full post –>In API v2024-10, inventory errors move from
to
warnings
with codes for stock issues. Usewarnings
to manage cart items or inform buyers of changes.Tags:
- Webhook
- 2024-10
New webhook topicapp/scopes_update
Read full post –>Webhook API
2024-10
addstopic, notifying apps of changes in granted access scopes, aiding in tracking installation permissions.
Tags:
- Webhook
- 2024-10
Newcreated_fulfillment_hold
field onfulfillment_orders/placed_on_hold
webhookRead full post –>Admin API v2024-10 adds
to
webhook, ensuring visibility of created holds even if released or deleted.
Tags:
- Action Required
- Admin GraphQL API
- 2024-10
Removal of deprecated product image mutations from the GraphQL Admin APIRead full post –>As of 2024-10, deprecated image mutations are removed from the GraphQL API. Use productCreateMedia, productDeleteMedia, productUpdateMedia, and productReorderMedia instead.
Tags:
- Admin GraphQL API
- 2024-10
Added FAILED_TO_RETRIEVE_BILLING_ADDRESS to CustomerPaymentMethodRevocationReason EnumRead full post –>As of GraphQL Admin API version 2024-10, the CustomerPaymentMethodRevocationReason object has a new enum value:
. This value is assigned when a customer payment...
Tags:
- Action Required
- Admin GraphQL API
- Admin REST API
- 2024-10
Order Management apps can no longer fulfill orders that are assigned to a different fulfillment serviceRead full post –>Starting October 2024, order management apps can't create fulfillments for third-party locations. Fulfillment service apps can fulfill orders if they have the correct access scopes.
Tags:
- Admin GraphQL API
- 2024-10
New parameter onfulfillmentServiceDelete
to control inventory behaviour on location removalRead full post –>GraphQL API v2024-10 adds
enum to
mutation, allowing
,
, or
inventory actions, impacting inventory management.
Tags:
- Admin GraphQL API
- 2024-10
fulfillmentOrderHold
mutation updated to return a fulfillment hold resourceRead full post –>As of the GraphQL Admin API version 2024-10, the
mutation will return the fulfillment hold that was created in a new
return field.
Learn more about the...
Tags:
- Action Required
- Admin GraphQL API
- 2024-10
New field and permission update to fulfillment hold resourceRead full post –>GraphQL Admin API 2024-10 adds
to
.
now requires
scope. Use
to check app-created holds.
Tags:
- Admin GraphQL API
- 2024-10
ProductInput
split intoProductCreateInput
andProductUpdateInput
in2024-10
Read full post –>In the 2024-10 Admin GraphQL API,
is split into
and
.
and
now use a new
product
argument.Tags:
- Admin GraphQL API
- 2024-10
Admin GraphQL API: new APIs for Pages, Articles, Blogs, and Comments now available in 2024-10Read full post –>Version 2024-10 of the Admin GraphQL API allows reading/modifying Pages, Articles, Blogs, and Comments with new types and queries, enhancing content management for developers.
Tags:
- Shopify App Store
Create App Store Ads on Tag-Level Category PagesRead full post –>App Store ads on the Shopify App Store now support targeting tag-level category pages, in addition to main and sub-category pages. For more information on App Store category page types, [see...
Tags:
- Action Required
- Admin GraphQL API
- 2025-01
Deprecating explicit access grants for app-owned metafieldsRead full post –>Specifying grants for specific apps on app-owned metafields is now deprecated. New apps will not be able...
Tags:
- Payments Apps API
- 2024-10
Added connection to order transaction from subscription billing attemptsRead full post –>New resource logs each subscription billing attempt, using idempotency keys to prevent duplicate orders. Successful attempts create orders, no impact on existing partners.
Tags:
- Payments Apps API
- 2024-10
Surface payment group id and payment session id on subscription billing attemptsRead full post –>New "SubscriptionBillingAttempt" resource logs billing attempts with idempotency keys to avoid duplicates, creating orders on success. No impact on existing partners.
Tags:
- Payments Apps API
- 2024-10
Add LocalPaymentMethodDetailsRead full post –>Added API resource for local payment methods payment details, enhancing transaction data access for developers.
Tags:
- Admin GraphQL API
- 2024-10
Introducing theme and theme file management in the Admin GraphQL APIRead full post –>API v2024-10 introduces admin API for Online Store Themes, matching REST API features. New queries and mutations enhance theme and file management, boosting efficiency for developers.
Tags:
- Admin GraphQL API
- 2025-01
Changing the default value of permitsSkuSharing argument in fulfillmentServiceCreateRead full post –>As of
2025-01
, the default value for theargument in the
mutation has been updated to true.
Please be aware that this argument is deprecated and...
Tags:
- Admin GraphQL API
- 2024-10
Introducing metafield definition capabilities in the admin APIRead full post –>API version 2024-10 introduces metafield definition management via Admin API, allowing developers to enable, disable, and query metafield capabilities for enhanced Shopify integration.
Tags:
- Action Required
- Admin GraphQL API
- 2024-10
Metafield Definition Capability Framework and Deprecation ofuse_as_collection_condition
Read full post –>API v2024-10 introduces the Metafield Definition Capability Framework, replacing
with
for better flexibility and extensibility.
Tags:
- Admin GraphQL API
- 2024-10
New inventory input fields in productSet mutation in version 2024-10Read full post –>GraphQL API v2024-10 introduces
for setting
available
orquantities in
and
mutations, enhancing inventory management.
Tags:
- Themes
Shopify CLI is now easier to install and faster for Liquid theme developmentRead full post –>Shopify CLI update: Instant dev server startup, no Ruby dependency, unified TypeScript commands, and headless Liquid console for streamlined theme development.
Tags:
- Themes
New Full-Funnel Theme Install Parameters and Now Firing E-Commerce Events on the Theme Listing PageRead full post –>Added
and
to theme install events for better merchant insights. Implemented Google e-commerce events for enhanced tracking and precise data analysis in Shopify Theme Store.
Tags:
- Tools
JavaScript Shopify Functions are now ~40% fasterRead full post –>As of Shopify CLI 3.67 and Javy 3.1, Shopify Functions built in JavaScript can see improved performance by as much as 40% when combined with [@shopify/shopify_function...
Tags:
- Shopify App Store
New Full-Funnel App Install Parameters and Now Firing E-Commerce Events on the App Listing PageRead full post –>New parameters
and
added for app install events in Shopify, plus Google e-commerce events for better tracking and data analysis on app listing pages.
Tags:
- Webhook
Product Feed webhooks now support per-market inventoryRead full post –>The
and
fields will now reflect country-specific inventory availability, scoped to the specified market country of the Product Feed. The Fulfillable Inventory...
Tags:
- Platform
Post-purchase offers limit is increasedRead full post –>Post-purchase upsell offers increased from 2 to 3, boosting order value potential. Review custom code for optimal buyer experience.
Tags:
- Action Required
- Admin GraphQL API
- 2024-10
Improvements in the GiftCard GraphQL endpoints and introducing GiftCardTransaction typesRead full post –>GraphQL Admin API 2024-10:
endpoints open to all; new
types. Rename
to
. Add
and transaction fields.
Tags:
- Action Required
- Admin GraphQL API
- 2024-10
The fulfillmentOrdersReleaseHolds Mutation Is DeprecatedRead full post –>As of the Admin API version 2024-10, the fulfillmentOrdersReleaseHolds mutation has been deprecated.
...
Tags:
- Admin GraphQL API
- 2024-10
Admin API includesurlRedirectsCount
Read full post –>As of Admin GraphQL API version
2024-10
, you can accessfield to retrieve the count of redirects.
Learn more about
on...
Tags:
- Admin GraphQL API
- 2024-10
New query attributes on products queryRead full post –>As of the 2024-10 version of the GraphQL Admin API, the
products
query filter has been expanded to allow filtering on additional attributes:,
and...
Tags:
- Action Required
- Admin REST API
- 2024-10
Field deprecations on the abandoned checkout REST APIRead full post –>Several fields deprecated from Abandoned Checkout REST API; switch to new GraphQL API by 2024-10 for continued support.
Tags:
- Admin GraphQL API
- 2024-10
Fulfillment Holds Now Able To Be Released by IDRead full post –>GraphQL Admin API 2024-10 adds
id
toand optional
to
mutation, allowing precise hold releases by ID.
Tags:
- Admin GraphQL API
- 2024-10
Admin API includesstatusPageUrl
field onOrder
Read full post –>As of Admin GraphQL API version
2024-10
, you can accessfield to retrieve the URL where the customer can check the order's current status.
Learn more about
Order
on...Tags:
- Admin GraphQL API
- Admin REST API
- Webhook
- 2024-07
Customer SMS Consent Collected From now returns Shopify when the buyer consents to SMS marketing in Shopify CheckoutRead full post –>From Sept 12, 2024,
returns
for SMS consent in Shopify Checkout, affecting 1st party and UI extensions; other flows remain unchanged.
Tags:
- Platform
Hydrogen September 2024 releaseRead full post –>Hydrogen v2024.7.5 enhances sitemaps, search, cart gift cards, and security. Fixes redirects and mobile links. Adds privacy utilities. Optimizes cart totals.
Tags:
- Action Required
- Admin GraphQL API
- Admin REST API
- 2024-10
Introducing PRODUCT_CATEGORY_ID in CollectionRuleColumn and Deprecating PRODUCT_TAXONOMY_NODE_ID for automated collection creationRead full post –>API v2024-10 introduces
in
for smart collections, replacing deprecated
. Update implementations for enhanced functionality.
Tags:
- Webhook
Updates to webhook retry mechanismRead full post –>Webhooks retry 8 times over 4 hours with exponential backoff. Original payloads are used; check timestamps for staleness. Address updates won't affect retries. Improves delivery reliability.