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:
- Admin GraphQL API
- 2024-07
GraphQL Admin API: new APIs for Menus are now available in 2024-07Read full post –>GraphQL Admin API 2024-07: Create, update, delete, and query menus with new mutations and queries, enhancing menu management capabilities for developers.
Tags:
- Shopify App Store
Structured app category details now available for 30 more categoriesRead full post –>Structured app category details now support 30 more categories, enhancing app-merchant matching, ad bidding, and discovery. Update fields on app listing pages for improved results.
Tags:
- Themes
JSON is better on Liquid themes nowRead full post –>JSON editing in Liquid themes now supports trailing commas and comments, simplifying refactoring. Apps parsing JSON should adapt to these changes for compatibility.
Tags:
- Action Required
- Storefront GraphQL API
- 2024-07
OptionValue in Storefront APIRead full post –>The new
type andfield in the API replacevalues, offering enhanced option details like swatches, improving data retrieval for developers.Tags:
- Action Required
- Admin GraphQL API
- 2024-07
OrderDisplayFulfillmentStatusnow returnsREQUEST_DECLINEDwhen appropriateRead full post –>As of
2024-10, OrderDisplayFulfillmentStatus will now returnfor an order that has had...Tags:
- Admin GraphQL API
- 2024-07
Add a new error code for handling missing payment method for subscription draft commitsRead full post –>As of 2024-07, you will receive a detailed error message when missing payment information for [subscriptionDraftCommit...
Tags:
- Admin GraphQL API
- 2024-07
draftOrderLineItemInput now accepts bundleComponents and the CartTransform function runs on all draft ordersRead full post –>GraphQL Admin API v2024-07: draftOrderLineItemInput now supports bundleComponents, enabling apps to manage bundle items in drafts. CartTransform auto-runs on all draft orders.
Tags:
- Action Required
- Admin GraphQL API
- 2024-07
Category on ProductInputRead full post –>Released new Taxonomy API with TaxonomyCategory type, updated product types, added category field to ProductInput, and deprecated shop.allProductCategories.
Tags:
- Action Required
- API
- 2024-07
UI Extensions - Support for split shipping in Shipping method option list and item targetsRead full post –>UI Extensions
2024-07support split shipping with new API targets and deprecated methods. Update logic for delivery groups and render modes. Compatible with2024-01and2024-04.Tags:
- Shopify App Store
We have refreshed app taxonomy for better discoverabilityRead full post –>App taxonomy updated for better discoverability. Review new categories, update your app's category, and check ad campaigns for potential impacts. One-time category change allowed.
Tags:
- Admin GraphQL API
- 2024-07
GraphQL Admin API:RefundLineItem.idfield addedRead full post –>As of
2024-07, you can use theto return the id of specifiedobject.Learn more about working with
on...Tags:
- Storefront GraphQL API
- 2024-04
Preserve line properties in CartLinesUpdate mutationRead full post –>The CartLinesUpdate mutation behavior has been updated to preserve...
Tags:
- Admin GraphQL API
- 2023-04
Updated default sort order for discount queriesRead full post –>As of 2023-04, the default sort key for
,, andqueries has changed to. Previously the default sort key was. This change...Tags:
- Action Required
- Storefront GraphQL API
- 2024-07
Deprecation ofbuyerIdentityInput.walletPreferencesin favour ofbuyerIdentityInput.preferences.walletRead full post –>As of
2024-07, we're deprecating. Useinstead.Learn more about these changes on...
Tags:
- API
Automatic Discount Functions now apply to B2B checkouts for reviewRead full post –>Discount Functions now support B2B draft orders, allowing discounts at checkout for B2B buyers. This enhances flexibility and efficiency in B2B transactions.
Tags:
- Platform
Merchants can now share all function run details for an app within the last 24 hoursRead full post –>It is now possible for merchants to share all function run details for an app within the last 24 hours with the app developer. This will share function run details for every function on the app,...
Tags:
- Admin GraphQL API
- 2023-07
Added Maximum Limit to number of fulfillment constraint rules for a shopRead full post –>We are adding a limit to the number of fulfillment constraint rules that can be applied to a shop - currently, this limit is 10. As a result, we are also adding a new error code to the API.
As...
Tags:
- Platform
Hydrogen June 2024 releaseRead full post –>Hydrogen v2024.4.3 introduces
hook,component, stable analytics, and upgrades to Remix 2.9.2, enhancing developer tools and performance.Tags:
- Platform
Discount Functions support on Shopify Point of SaleRead full post –>POS app v9.10 supports advanced Discount Functions, enabling automatic discounts, smart grid tiles, and improved error handling, enhancing developer flexibility and merchant capabilities.
Tags:
- Action Required
- Admin GraphQL API
- 2024-07
Introducing the URLParameterValue field on all marketing activities and aligned types on userErrors in the Marketing Activity APIRead full post –>API v2024-07 adds
for tracking in.is now required forerrors.Tags:
- Shopify App Store
A little spring cleaning for your App Store listingRead full post –>Listing pages refreshed for better readability; sticky sidebar added for key info. Structured features support expanded. No changes to listing functionality.
Tags:
- Admin GraphQL API
- 2024-07
Added new fieldordersCountto the query rootRead full post –>As of version
2024-07of the Admin GraphQL API, you can use the newfield to count the orders for a given shop.Learn more about
on...Tags:
- Admin GraphQL API
- 2024-07
New fields on Order GraphQL ObjectRead full post –>As of Admin API
2024-07, Order object will expose the following new fields:- staffMember *...
Tags:
- Admin GraphQL API
- 2024-07
New mutation to delete an orderRead full post –>As of GraphQL Admin API 2024-07 version, you can make use of a new mutation to delete an order.
Learn more about
on...Tags:
- Action Required
- Admin GraphQL API
- 2024-10
Deprecating the Ability to Set Available Quantities on Already Active States on theInventoryActivateGraphQL MutationRead full post –>As of Admin GraphQL API version
2024-10, we're deprecating the ability to set the available quantity on theGraphQL mutation for already active states. Moving forward, use the...Tags:
- Storefront GraphQL API
- 2024-07
Note length is now validated (<5000 char)Read full post –>As of Storefront API version 2024-07, you will get a
user error in cart mutations in case the note exceeds the maximum number of 5000 characters.Tags:
- Admin GraphQL API
- 2024-07
Updates to MetafieldAccessInput and MetafieldAccessUpdateInput enum valuesRead full post –>Starting July 2024,
andwill useandenums for access control.Tags:
- Shopify App Store
More personalized guidance during app submissionRead full post –>Pre-select app capabilities early to receive personalized guidance during app submission
Tags:
- API
- 2024-04
Customize the address autocomplete provider in Checkout with the Address Autocomplete APIRead full post –>Developers can now customize Shopify Checkout's address autocomplete using the Address Autocomplete API, enabling integration with third-party apps for enhanced suggestions.
Tags:
- Shopify App Store
Even more personalized guidance during app submissionRead full post –>Pre-select app capabilities early for tailored requirements. If review is paused, receive clear issue summaries and an easy resubmission process. English rollout starts this week.
Tags:
- API
- 2024-01
Apps can now trigger marketing automations that use the Customer subscribed to email marketing triggerRead full post –>Apps can now trigger Shopify's marketing automations via the Customers API. Use
for email consent updates within 24 hours to activate workflows. Avoid duplicate emails.Tags:
- Admin GraphQL API
- Admin REST API
- Customer Account API
- Liquid
Zero-value tax lines are now returned for tax exempt ordersRead full post –>API now returns tax lines for tax-exempt orders, even with
price=0. Full rollout by May 23, 2024. Ensure tax registrations are set for affected stores.Tags:
- Storefront GraphQL API
- 2024-04
New preferences fields for prefilling checkout in the Storefront (cart) APIRead full post –>As of 2024-04, the Cart API's
preferencesobject allows prefilling checkout sessions, streamlining delivery and pickup options for merchants, enhancing the checkout process.Tags:
- API
- 2024-07
Better support for accelerated checkout methods in payment customization functionsRead full post –>The Payment Customization API now offers improved naming for checkout methods and lets Shopify Plus merchants control method visibility at checkout steps with a new
placementsargument.Tags:
- Tools
New checkout functionality for merchants on Basic, Shopify, and Advanced plansRead full post –>UI extensions and web pixels are now available for app customization on Thank you and Order status pages. Scripts will be phased out; replace with compatible apps or rebuild using new tools.
Tags:
- Admin GraphQL API
- 2024-07
The orderCapture API now supports finalCaptureRead full post –>Shopify Plus merchants can now use the
parameter in orderCapture to release uncaptured funds on final authorization, enhancing customer satisfaction and reducing chargebacks.Tags:
- Liquid
Enhanced handling of large quantities in the Carts API update endpointRead full post –>Carts API
updateendpoint now returns422status for quantities over 1,000,000, alerting users to the cap. No change in inventory level checks.Tags:
- Admin GraphQL API
- 2024-07
Updates to metafield access controlsRead full post –>Apps can now view the
accessfield of metafield definitions they don't own.adminandstorefrontfields return more values, with new defaults for undefined grants.Tags:
- Platform
Hydrogen May 2024 releaseRead full post –>Hydrogen v2024.4.2 introduces Oxygen redeploys, B2B support, Node 21 compatibility, improved HMR, request profiling, and security. New
h2 upgradedetects outdated devDependencies.Tags:
- Admin GraphQL API
- 2024-07
New error code added for the MetafieldDefinitionDelete mutationRead full post –>As of API version 2024-07, we've added the
error code to themutation. This error code is returned if you attempt to delete a...Tags:
- Action Required
- Themes
- Liquid
Cart cookie value now includes key paramRead full post –>Update cart cookie to include key param to retain buyer details. Enforced in 1 week. Check theme code for assumptions on cookie format; no action needed if default value is used.
Tags:
- API
Pixels now support more customer privacy setting configurationRead full post –>You can now configure the customer privacy permissions and data sale settings for app pixels using the Web Pixel API. This will provide more insights by collecting events whenever the proper...
Tags:
- Liquid
Image and swatch presentations for product filtersRead full post –>Create visual filters with image presentation in Shopify's Liquid API using
for detailed imagery. Requires Search & Discovery app for merchant setup.Tags:
- Action Required
- Admin GraphQL API
- 2024-07
ShopifyQL Admin GraphQL API sunsetRead full post –>As of Admin API 2024-07, ShopifyQL API is deprecated. Use Admin GraphQL APIs like Orders and Web Pixels for data extraction. Adjust your integrations accordingly.
Tags:
- Themes
Translatable Default Values in Theme Settings SchemaRead full post –>Now, theme developers can utilize schema translation files to make default values in theme sections translatable. This ensures that themes are equipped to support multiple languages right from...
Tags:
- Admin GraphQL API
- 2024-07
GraphQL Admin Files Query includes 3D Models and External VideosRead full post –>As of version 2024-07, 3D Models and External Videos will be included in the GraphQL Admin Files Query.
Tags:
- Admin GraphQL API
- 2024-07
Mobile Platform Application releaseRead full post –>As of version 2024-07 of the GraphQL Admin API, we are introducing the
resource. This new resource facilitates the development and operational integration of shared web...Tags:
- API
- 2024-07
WebhookincludeFieldsnow apply to all topicsRead full post –>As of version 2024-07 of the webhooks API, the includeFields that are...
Tags:
- Admin GraphQL API
- 2024-07
GraphQL Admin API: Support for metafield connections in online store objectsRead full post –>As of version 2024-07 of the GraphQL Admin API, you can use the
Metafieldandconnections in the...Tags:
- Action Required
- Admin GraphQL API
- 2024-07
GraphQL Admin API:locationfield removed from theOrderobject.Read full post –>As of GraphQL Admin API version 2024-07 the
locationfield on theOrderobject has been removed. Use thefield instead.Learn more about the Order object on...