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 API2025-04New enum values for
FulfillmentOrderRejectionReason
Read full post –>We've added new
enum values for more detailed error messages.
- Customer Account API2025-04
@inContext
directive added to the Customer Account APIRead full post –>directive added to the 2025-04 version of the Customer Account API to help integrate with international markets
- Admin GraphQL API2025-04
productSet
andcustomerSet
mutations now support upserts and custom IDsRead full post –>As of API version 2025-04 of the GraphQL Admin API, the
and
mutations can upsert by
identifier
, simplifying record management. - POS Extensions2025-04POS UI Extensions 2025-04 UpdateRead full post –>
Renamed NewTextFieldProps to TextFieldProps. Added support for transaction complete, cash tracking, and receipt footer targets. Introduced POSReceiptBlock component for receipt footer.
- Admin GraphQL API2025-04New enum values for
CustomerPaymentMethodRevocationReason
Read full post –>Added new enum values to
:
,
,
- Admin GraphQL API2025-04New theme file metadata fields added to
OnlineStoreThemeFileOperationResult
objectRead full post –>The
mutation now returns theme file metadata directly, eliminating the need for extra fetch requests to verify updates.
- Admin GraphQL APIWebhook2025-04New finance KYC information field available for Shopify-approved finance appsRead full post –>
Shopify-approved finance apps can access shop finance details and subscribe to related webhooks
- Admin GraphQL API2025-04Customer RFM group now available in GraphQL Admin APIRead full post –>
Added rfmGroup field to customer statistics in the Admin GraphQL Admin API to expose customer segmentation data based on purchasing patterns.
- Admin GraphQL API2025-07
draftOrderCount
available in 2025-07Read full post –>The
query is now available in the 2025-07 stable version of the GraphQL Admin API. Previously, it was...
- Payments Apps API2025-07Support for card not present transaction details in PaymentsApps APIRead full post –>
The Payments Apps API now supports AVS and CVV details for card-not-present transactions.
- Admin GraphQL APILocation ID Queryable with Inventory ScopesRead full post –>
location.id
can now be queried withor
scopes. Other
Location
fields still need. Applies to all API versions.
- Admin GraphQL API2025-04View gift card maximum valuesRead full post –>
Use the
query to retrieve the maximum values for purchased and issued gift cards.
- Customer Account API2025-04New field
fulfillmentStatus
added to theOrder
type of the Customer Account APIRead full post –>API v2025-04 adds
to
Order
, showing the order's overall fulfillment status for display. - Admin GraphQL API2025-04New
articleAuthors
query in the GraphQL Admin APIRead full post –>To fetch a list of article authors for a store, use the new
query.
- Admin GraphQL API2025-04New filter options added to
pages
,articles
, andcomments
queriesRead full post –>articles
,pages
, andcomments
queries now have full filter parity with the REST Admin API - ToolsDeveloper Preview: Localhost-based development for
shopify app dev
Read full post –>Developer Preview: Serve your app on localhost with a self-signed HTTPS certificate using Shopify CLI.
- Admin GraphQL APIAdmin REST APIInventoryItem Webhooks Accessible with Product ScopesRead full post –>
Webhook scopes for InventoryItem are now flexible, allowing
or
for
,
,
across all API versions.
- Built for ShopifyShip and carry out in a single order on POS is now available for Retail Pro Merchants using eligible tax softwareRead full post –>
How Retail Ship and carry out orders will impact the behaviour of order and fulfillment order objects
- Admin GraphQL API2025-07New additions to delivery promise participants APIsRead full post –>
Locations can now be used in delivery promise participant queries and mutations in the unstable GraphQL Admin API, with full release in 2025-07. Filter products by delivery promise participants.
- PlatformHydrogen March 2025 ReleaseRead full post –>
Hydrogen v2025.1.3 adds support for Vite 6 and enables the
future flag for Remix.
- PlatformApp Bridge Title Bar visual updateRead full post –>
Apps will see an improved visual appearance of the App Bridge Title Bar API starting to rollout, to match the new...
- Admin GraphQL APIWebhook2025-04New
planHandle
field for managed pricing app subscription plansRead full post –>App subscription plans now include persistent plan handles, making it easier to query for plan data.
- Storefront GraphQL API2025-07Storefront API Cart now exposes selling plan errorsRead full post –>
Version 2025-07 of the GraphQL Storefront API improves error handling for selling plans. Cart mutations now specify errors for missing or inapplicable selling plans.
- ThemesLiquid support for OKLCH colorsRead full post –>
Liquid now supports OKLCH colors, enabling a broader color range. New features include
filter and enhanced
color
object properties for OKLCH. - Admin GraphQL APIAdmin REST APIRe-enabled customer search terms in the GraphQL and REST Admin APIsRead full post –>
The GraphQL and REST Admin API now support various customer-related search terms that were disabled in API version 2024-07. For example:
,
city
,company
, and more. - Admin GraphQL APIDraft Orders automatically purged after 1 year of inactivityRead full post –>
Draft orders inactive for a year will auto-delete starting April 1, 2026 to improve data management and app performance. Applies to orders created after April 1, 2025.
- API2025-04Using custom ids to look up collections, locations, orders, and product variantsRead full post –>
The 2025-04 Admin API allows custom identifier lookup for collections, locations, orders, and product variants.
- ToolsShopify.dev MCP ServerRead full post –>
MCP server for Shopify dev assistant
- Admin GraphQL APIRetail Exchanges now use the Shopify Exchanges implementationRead full post –>
Shopify Exchange Platform now supports Retail Exchanges, consolidating operations into a single Return. Update integrations for unified sales agreements. ExchangeV2 APIs deprecated in 1 year.
- Shopify App StoreAds are now available on mobile, plus more surfaces to target merchantsRead full post –>
Shopify App Store now supports mobile ads and targeting on homepage and category page ads. Set bid prices for devices and access detailed mobile ad reports via Ads Manager in your Partner Dashboard.
- Action RequiredAdmin GraphQL API2025-04Deprecating PriceListUserErrorCode valuesRead full post –>
Starting from 2025-04, unused
values will be removed.
- Action RequiredAPINow available: JS Buy SDK v3.0Read full post –>
JS Buy SDK v3.0 is now available
- Admin GraphQL APIAdding defaultPhoneNumber field to CustomerRead full post –>
As of GraphQL Admin API version 2025-04, the
field is introduced on the
Customer
object to support querying a customer's phone number and marketing state.Learn more...
- Admin GraphQL API2025-04Adding defaultEmailAddress field to CustomerRead full post –>
As of GraphQL Admin API version 2025-04, the
field is introduced on the
Customer
object to support querying a customer's email address and marketing state.Learn more...
- Action RequiredPOS Extensions2025-04End of Compatibility for Old POS UI Extensions VersionsRead full post –>
Shopify API 2025.04 ends support for specific POS UI Extension versions. Update to the latest version to ensure functionality with POS 9.31 and beyond.
- APINew developer documentation now available for Shopify CollectiveRead full post –>
New Shopify Collective docs offer guidance on integrating systems using Shopify's API and webhooks, enhancing workflow integration for developers.
- Storefront GraphQL API2025-04Storefront API Cart now includes payment informationRead full post –>
As of version 2025-04 of the GraphQL Storefront API, the Cart object includes a
payment
field that indicates whether a payment has been added. Additionally, it is possible to determine the type... - POS ExtensionsPOS UI Extensions: Modal updateRead full post –>
In POS version 9.30, the POS UI Extensions modal will be enhanced to prevent accidental dismissals. You won't be able to dismiss the modal by swiping down or tapping outside of it. This update is...
- Admin GraphQL API2025-04orderEditAddVariant mutation applies contextual pricing by defaultRead full post –>
As of the 2025-04 API version, the
API will adhere to the pricing configurations set for Markets and Company Locations.
- API[Cart AJAX API] Inventory error message updatesRead full post –>
Updated AJAX API error messages for inventory requests: "Only available quantity added" and "Max quantity in cart." Affects
add.js
,change.js
, andupdate.js
endpoints. - ToolsIntroducing the .dev Assistant VSCode ExtensionRead full post –>
Introducing the .dev Assistant extension for VSCode, enhancing your development workflow directly in the editor for improved efficiency.
- Admin GraphQL APINew GraphQL APIs for Inventory Transfers ManagementRead full post –>
New Transfers and Shipment APIs enable seamless integration with IMS/ERP, allowing full transfer management. Currently in "Unstable" stage, expected release candidate by July 2025.
- Action RequiredAdmin REST APIStorefront GraphQL API2025-04Checkout APIs will be shut down April 1, 2025Read full post –>
All impacted apps need to update to the Storefront Cart API before April 1, 2025 to avoid disruptions.
- Admin GraphQL API2025-07FeeSale fee field is nullable as of 2025-07Read full post –>
As of 2025-07, FeeSale.fee is nullable, allowing null values for deleted fees. Prior versions return deleted fees. Update your code to handle null fees.
- Action RequiredAdmin GraphQL APIStorefront GraphQL API2025-04AMAZON_PAY enumerated in DigitalWalletsRead full post –>
The DigitalWallets enum now includes AMAZON_PAY, enabling its use in Storefront and Admin GraphQL APIs which can determine if Amazon Pay is available to buyers and has been used in transactions.
- Admin GraphQL API2025-04The
X-Shopify-API-Deprecated-Reason
HTTP header will return actual GraphQL deprecations if anyRead full post –>As of
2025-04
, theHTTP header will return the list of detected deprecations instead of a generic URL.
- Admin GraphQL API2025-04New customer address capabilities in the Admin APIRead full post –>
2025-04 adds
,
, and
mutations for more granular control on customer addresses.
- Action RequiredAdmin GraphQL API2025-07Metafield description input field removalRead full post –>
The
description
field for metafields is being removed inunstable
. - Admin GraphQL APIAdmin REST APICustomer Account API2025-04Reserved prefix protection for metafields and metaobjectsRead full post –>
New metafield namespaces and metaobject types can not have prefixes that end with double hyphens (e.g., "foo--"). Existing definitions remain unaffected.
- Admin GraphQL APIAdmin REST APIWebhookNo-op for unchanged metafields and metaobjectsRead full post –>
Metafield/metaobject writes that don't change values won't trigger actions like webhooks, enhancing efficiency by reducing unnecessary processing in select mutations and bulk operations.