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-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 uniqueto 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....
Tags:
- Admin GraphQL API
- 2024-04
New GraphQL product APIs that support up to 2048 variants now available in 2024-04Read full post –>New GraphQL APIs support up to 2000 product variants, manage options, and use
for full product state updates. Deprecated:and REST/products,/variants.Tags:
- Action Required
- Admin GraphQL API
- Admin REST API
- 2024-04
Deprecation timelines related to new GraphQL product APIsRead full post –>The 2024-04 API release introduces new GraphQL product APIs, deprecating
variantsandoptionsmanagement inand/productsand/variantsREST endpoints. Migrate by Feb 1, 2025.Tags:
- Admin GraphQL API
- 2024-04
ShippingLineInput now accepts priceWithCurrencyRead full post –>As of 2024-04, you can use
to provide the price of the shipping rate along with the currency, whereaspriceuses the shop currency. Ifis provided,...Tags:
- API
- 2024-04
Set LineItem attributes using CartTransformRead full post –>As of 2024-04, use
MergeandExpandto set LineItem attributes on Bundle items or components, enhancing customization in Shopify.Tags:
- Storefront GraphQL API
- 2024-04
Storefront API now supports per-market Fulfillable InventoryRead full post –>Storefront API 2024-04 adds
for queryingproductandinventory by market country. Ensure Fulfillable Inventory is enabled.Tags:
- API
- 2024-04
Fulfillment Orders Searching and Sorting byupdated_atfieldRead full post –>As of 2024-04 developers can now sort and search Fulfillment Orders in GraphQL queries by the
field.This will help app developers and fulfillment services to prioritize their work...
Tags:
- Action Required
- Admin GraphQL API
- Admin REST API
- Storefront GraphQL API
- 2024-04
Deprecation of Checkout APIsRead full post –>The Checkout API will be deprecated by April 2024. Migrate to the Storefront Cart API or Checkout Sheet Kit by April 2025 to ensure continued functionality and access to new features.
Tags:
- Action Required
- Admin GraphQL API
- 2024-04
receiptremoved from OrderTransaction GraphQL Admin APIRead full post –>The
field will be removed in April 2024. Usefor JSON-formatted data to simplify integrations and API usage.Tags:
- Action Required
- Storefront GraphQL API
- 2024-04
Update note to be required in cartNoteUpdateRead full post –>As part of the GraphQL Storefront API 2024-04 API release, we've updated the
API to make thenoteargument required.Learn more about the
Cartobject on...Tags:
- Action Required
- Admin GraphQL API
- 2024-04
Removal of Customer order-related sort keys on Admin APIRead full post –>As of GraphQL Admin API version 2024-04, the following Customer sort keys have been deprecated:
,,. Ordering customers by these attributes is...Tags:
- Admin GraphQL API
- 2024-04
Introducing metafieldsDeleteRead full post –>As of 2024-04, you can use the
mutation to delete up to 25 metafields at once.Learn more about metafields on...
Tags:
- Action Required
- Admin GraphQL API
- 2024-04
Inventory Mutations and Fields RemovalRead full post –>Admin API 2024-04 removes certain inventory fields and mutations. Replace them with new fields and mutations for handling quantities. Deprecated fields work until 2024-04 support ends.
Tags:
- Admin GraphQL API
- 2024-04
Newinventory_managementboolean argument onfulfillmentServiceUpdatemutationRead full post –>As of 2024-04 version Admin GraphQL API, you can update
boolean value on the FulfillmentService object using the [fulfillmentServiceUpdate...Tags:
- Action Required
- Admin GraphQL API
- Admin REST API
- 2024-04
New Create Fulfillment Request ValidationRead full post –>Admin v2024-04: Duplicate
entries inare disallowed. Combine payloads with the same ID for REST and GraphQL fulfillment creation.Tags:
- Action Required
- Admin GraphQL API
- Admin REST API
- 2024-04
Deprecation of thefulfillmentService.fulfillmentOrdersOptInfieldRead full post –>The
field is deprecated. In API2024-04, it defaults totrueand will be removed in2024-07. Stop using it for new fulfillment services.Tags:
- Action Required
- Admin GraphQL API
- 2024-04
Removal ofproductDuplicateAsyncmutation from the GraphQL Admin APIRead full post –>As of 2024-04, we're removing the deprecated
mutation. The mutation was deprecated since2023-07version.Use the...
Tags:
- Admin GraphQL API
- 2024-04
Adding additional value to FulfillmentOrderAssignmentStatusRead full post –>API version 2024-04 adds
filter to, allowing retrieval of unrequested fulfillment orders for app-owned locations.Tags:
- API
- 2024-04
New Storefront GraphQL APIs for B2B are available in 2024-04Read full post –>GraphQL Storefront API
2024-04addsfor B2B queries, enabling product, price, volume, and company-specific cart queries for enhanced B2B integration.Tags:
- API
- 2024-04
Customer APIs: Allow querying of customer subscription contractsRead full post –>The 2024-04 GraphQL Customer API release adds
fields, enabling queries for all or specific customer subscription contracts, enhancing data retrieval.Tags:
- Action Required
- Admin GraphQL API
- 2024-04
New Error codes and updated error code mapping for payment and billingRead full post –>As of 2024-04, new error codes added to
. Key mappings updated for Braintree, Paypal, and Stripe, impacting error handling and classification.Tags:
- API
- 2024-04
Read full post –>[Checkout Branding API] New color schemesTags:
- API
- 2024-04
[Checkout Branding API] Initial release of header and footer style customizationsRead full post –>Version 2024-04 of the Admin API introduces
mutation to customize checkout header/footer withandpaddingcontrols.Tags:
- Action Required
- Admin GraphQL API
- 2024-04
Taxonomy APIRead full post –>Shopify's 2024-04 API introduces a public product taxonomy, replacing deprecated APIs. Developers can now access standardized categories, attributes, and values via
.Tags:
- Action Required
- Platform
Orders with payment terms no longer always include anOrderTransactionwhen created from a Draft OrderRead full post –>Draft Orders with payment terms no longer auto-create
. Update apps to manually record payments or methods to generate.Tags:
- API
Introducing the new Pickup Points in early access - we want your feedback!Read full post –>Introducing Pickup Points for Shopify Plus: build custom apps for checkout pickup at locations like post-offices. Integrate third-party networks and customize delivery and pricing.
Tags:
- Action Required
- Shopify App Store
Plan-level trial configuration in the App Store app listing submission pageRead full post –>Trials are now plan-level, not app-level; free plans can't have trials. Update trial data in your app listing by April 29. Manage settings in the Partners Dashboard under Distribution.
Tags:
- Shopify App Store
Introducing a new, guided app submission processRead full post –>Get your apps published faster with our streamlined app review experience. It provides a clear, guided process that ensures you’ve checked off some key requirements before submitting and contextual...
Tags:
- Action Required
- Admin GraphQL API
- 2024-04
Removal of deprecated tactics and add ability to query is_externalRead full post –>The 2024-04 API update removes deprecated marketing tactics and introduces the
attribute to identify externally managed activities, impacting marketing API integrations.Tags:
- API
Network access for Shopify Functions is now available in early accessRead full post –>Early access to network access for Shopify Functions enables enterprise merchants to integrate with external services. Supported functions include cart validation and delivery option generators.
Tags:
- Admin REST API
- 2024-04
REST API 2024-04 reports resource deprecationRead full post –>As of REST API 2024-04, we’re deprecating the Reports resource.
The REST API Reports resource used to create custom reports in...