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:
- 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
NOTE_TOO_LONGuser 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
RESERVED_NAMESPACE_ORPHANED_METAFIELDSerror 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...
Tags:
- Admin GraphQL API
- 2024-01
Read full post –>TheDiscountEffectInputinput object now acceptsamountTags:
- Admin GraphQL API
- 2024-07
GraphQL Admin API:retailLocationfield added toOrderobjectRead full post –>As of GraphQL Admin API version 2024-07, you can use the new
field on theOrderobject to query the physical location where a retail order is created or completed.Learn...
Tags:
- API
Update: New maximum value for gift cardsRead full post –>Starting May 15, 2024, the Gift Card API enforces a $2,000USD issuance limit. A new query helps check limits per currency. Existing cards remain unaffected.
Tags:
- Platform
App Bridge Performance Enhancements & Potentially Breaking ChangesRead full post –>Shopify apps using
name="app-iframe"must upgrade to App Bridge React v4 or use a uniquename="frame:${APP_ID}/main"to prevent breakage due to upcoming performance enhancements.Tags:
- Tools
Shopify CLI is now unified for app, theme, and Hydrogen developmentRead full post –>Shopify CLI 3.59 unifies commands in one npm package, recommended as a global install, reducing setup time and conflicts. Local use in apps and Hydrogen projects remains supported.
Tags:
- Action Required
- Admin GraphQL API
- 2024-07
InventoryItem Input UnificationRead full post –>As of Admin GraphQL API 2024-07,
unifies input types for inventory updates, adding fields likeskuandfor streamlined data handling.Tags:
- Platform
Hydrogen April 2024 releaseRead full post –>Hydrogen v2024.4.0 adds Shopify analytics, stable Vite support, SEO tools,
env pushcommand, Customer Account API, and SSL tunneling, enhancing performance and developer experience.Tags:
- Storefront GraphQL API
- 2024-07
Storefront API Cart now supports applying Gift CardsRead full post –>GraphQL Storefront API 2024-07 adds support for adding, updating, and querying Gift Cards in Cart via
and. Query applied Gift Cards with.Tags:
- Admin GraphQL API
- 2024-07
DraftOrderInput now accepts discountCodes and acceptAutomaticDiscounts.Read full post –>GraphQL Admin API v2024-07: DraftOrderInput now supports discountCodes and acceptAutomaticDiscounts. New DraftOrderPlatformDiscount type details platform discount allocations.
Tags:
- Platform
Support for Plus merchants currently using products to represent additional fees or charges in checkoutRead full post –>We have released a feature for Plus merchants who
- Use products to represent additional fees or charges in checkout
- Are currently using checkout.liquid to customize the order summary
- Need...
Tags:
- Admin GraphQL API
- 2024-07
Query cash transactions for a Shopify POS cash tracking sessionRead full post –>In version 2024-07, the GraphQL Admin API allows querying cash transactions linked to Shopify POS cash tracking sessions via the new
connection.Tags:
- Storefront GraphQL API
- 2024-04
CartDiscountCode#code has been fixed to be case insensitive.Read full post –>has been corrected to be case insensitive. For example, providing the inputonorwill return a...Tags:
- Platform
Expanded targets for Admin Action ExtensionsRead full post –>Integrate apps with admin action extensions at more Shopify admin locations, including draft orders, abandoned checkouts, and variant pages, enhancing app functionality and reach.
Tags:
- Storefront GraphQL API
- 2024-04
Cart checkoutChargeAmount returns amount before the discountsRead full post –>As of version 2024-04 the Storefront API field
will now return an estimated amount before taxes and discounts. In previous versions...Tags:
- Action Required
- API
Preloaded Cart and Checkout Validation configuration in Admin UI extensionsRead full post –>Preloading Validation records eliminates
fetchcalls. Migrate toaccess scope soon to ensure continued functionality.Tags:
- API
- 2024-04
New sort options for fulfillment ordersRead full post –>As of GraphQL Admin API version 2024-04, you can use the new sort options in...
Tags:
- Admin GraphQL API
- 2024-01
New access scopes added to the Validation GraphQL Admin APIRead full post –>scope is now needed forvalidationqueries;for,,mutations. Update extensions accordingly.Tags:
- Action Required
- Admin GraphQL API
- 2024-04
Unification of count fieldsRead full post –>As of April 2024, count fields are standalone with consistent naming and return a
Countobject. They support filtering and simplify argument effects. Migration updates field names.Tags:
- API
- 2024-04
Company and CompanyLocation metafields are now available in the Customer Account APIRead full post –>As of 2024-04, you now have read access to metafields on Company and CompanyLocation resources via the Customer Account API.
Learn more about the
Metafieldobject on the GraphQL Customer...Tags:
- Admin GraphQL API
- 2024-04
Metafield-linked product optionsRead full post –>As of version 2024-04 of the Admin GraphQL API, you can use the
,, andmutations to create metafield-linked product options....