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 Updates- Admin GraphQL API2024-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...
- Action RequiredAdmin GraphQL APIAdmin REST API2024-10Order 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.
- Admin GraphQL API2024-10Added 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...
- Action RequiredStorefront GraphQL API2024-10Cart 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. - Action RequiredAdmin GraphQL APIAdmin REST API2024-10Querying events through the
events
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.
- Admin GraphQL API2024-10Add subscription status updates to bulkOperationRunMutationRead full post –>
Subscription Status updates can now be run with the bulkOperationRunMutation.
The following mutations have been added:
*...
- Admin GraphQL API2024-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. - Admin GraphQL API2024-10Admin 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.
- Shopify App StoreCreate 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...
- Action RequiredAdmin GraphQL API2025-01Deprecating 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...
- Admin GraphQL API2024-10Introducing 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.
- Admin GraphQL API2025-01Changing 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...
- Admin GraphQL API2024-10Introducing 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.
- Action RequiredAdmin GraphQL API2024-10Metafield Definition Capability Framework and Deprecation of
use_as_collection_condition
Read full post –>API v2024-10 introduces the Metafield Definition Capability Framework, replacing
with
for better flexibility and extensibility.
- Admin GraphQL API2024-10New 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.
- ThemesShopify 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.
- ThemesNew 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.
- ToolsJavaScript 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...
- Shopify App StoreNew 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.
- WebhookProduct 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...
- PlatformPost-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.
- Action RequiredAdmin GraphQL API2024-10Improvements 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.
- Action RequiredAdmin GraphQL API2024-10The fulfillmentOrdersReleaseHolds Mutation Is DeprecatedRead full post –>
As of the Admin API version 2024-10, the fulfillmentOrdersReleaseHolds mutation has been deprecated.
...
- Admin GraphQL API2024-10Admin API includes
urlRedirectsCount
Read full post –>As of Admin GraphQL API version
2024-10
, you can accessfield to retrieve the count of redirects.
Learn more about
on...
- Admin GraphQL API2024-10New 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...
- Action RequiredAdmin REST API2024-10Field 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.
- Admin GraphQL API2024-10Fulfillment 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.
- Admin GraphQL API2024-10Admin API includes
statusPageUrl
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... - Admin GraphQL APIAdmin REST APIWebhook2024-07Customer 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.
- PlatformHydrogen 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.
- Action RequiredAdmin GraphQL APIAdmin REST API2024-10Introducing 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.
- WebhookUpdates 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.
- ToolsStatic app navigation for admin apps is no longer supportedRead full post –>
Static app navigation for admin apps is deprecated. Use App Bridge components for navigation. Delete existing menus via Partners dashboard by Dec 2024; auto-removal by Dec 2026.
- Action RequiredAdmin GraphQL API2024-10Removing V2 suffix from fulfillmentCreateV2 and fulfillmentTrackingInfoUpdateV2Read full post –>
As of
2024-10
, we're deprecatingand
. Instead, please use
and
.
Note that the...
- Action RequiredAdmin REST API2024-10The REST location resource requires
locations
scopeRead full post –>The 2024-10 Admin REST API requires the
scope to access the location resource. Without it, a 403 Forbidden error occurs. Update your app permissions accordingly.
- Shopify Theme StoreFresh theme rows for Theme Store homepageRead full post –>
To help merchants discover the freshest and most well-integrated themes for their store, we've shipped an update to the Theme Store homepage to highlight Top and New themes (published in the last...
- LiquidStorefront GraphQL API2024-10Storefront Product Taxonomy Category APIRead full post –>
GraphQL Storefront API 2024-10 now supports retrieving product taxonomy categories, enhancing storefront customization. Available via both GraphQL and Liquid APIs for improved buyer experience.
- Admin GraphQL API2024-10Allow item activation at legacy locationRead full post –>
GraphQL Admin API 2024-10 adds
to
mutation, enabling inventory activation at non-SKU-sharing locations. Ensure parameter is true for such activations.
- Action RequiredAdmin GraphQL API2024-10ReverseFulfillmentOrderLineItem.fulfillmentLineItem field is nullable as of 2024-10Read full post –>
As of 2024-10,
is nullable. Older API versions will error if
is missing.
- Admin GraphQL API2024-10Admin API removes
lineItemsMutable
field onOrder
Read full post –>As of Admin GraphQL API version
2024-10
, useinstead of
field to get a list of the order's line items.
Learn more about
Order
on... - Admin GraphQL API2024-01Customer, Order, Company, and Model3d GraphQL types available in MetafieldReference union for 2024-01 and onwardRead full post –>
We are retroactively adding Customer, Order, Company, and Model3d graphql types to the MetafieldReference union for...
- Action RequiredCustomer Account GraphQL API2024-01Protected customer data access required to use the Customer Account APIRead full post –>
Apps must meet Level 1 Protected Customer Data Requirements to access the Customer Account GraphQL API, affecting public apps but not Hydrogen, Headless, or Custom Apps.
- Admin GraphQL API2024-10Adding
productVariantsCount
GraphQL field.Read full post –>As of
2024-10
version, we are addingfield to the Admin GraphQL API.
Learn more about...
- Built for ShopifyBuilt for Shopify Technical criteria checklist has been updatedRead full post –>
Renamed criteria, updated app distribution layout, added category-specific section, merged safety and design standards, and removed outdated app listing requirements for clarity.
- Shopify Theme StoreUpdates to Feature Filters, Theme Listing & Partner PagesRead full post –>
- Merchants can now filter themes by 3 new features: "Quick Order List", "Sign in with Shop" & "Swatch Filters". And we have removed 3 feature filters: "Product reviews", "Event Calendar" & "Store...
- Admin GraphQL API2024-10Remove unused error codes from LocationDeactivateUserErrorCodeRead full post –>
The 2024-10 GraphQL Admin API release removes
and
from
. Update code to remove checks.
- Admin GraphQL API2024-10ShopifyPaymentsAccount GraphQL Admin API unused fields removedRead full post –>
As of GraphQL Admin API version 2024-10, we're cleaning up the
endpoint and removing several unused fields.
- ToolsShopify Functions log streaming and replay is now generally availableRead full post –>
As of Shopify CLI 3.66, log streaming and replay for Shopify Functions is generally available.
Log streaming for Shopify Functions enables faster development, testing, and debugging of functions...
- Action RequiredAdmin GraphQL API2024-10Breaking changes to media in GraphQL API's ProductSet mutation in version 2024-10Read full post –>
GraphQL API v2024-10 introduces
for enhanced media handling in
. Replaces
and
with
files
andfile
fields for better file management. - PlatformMetafields and metaobjects reserved prefixes now supported in theme app extensionsRead full post –>
When accessing metafield namespaces or metaobject types, you no longer need to hard code
. The
$app
reserved prefix is now available to use in your Liquid files.Learn more...