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-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
UPDATED_ATfield.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:
LAST_ORDER_DATE,ORDERS_COUNT,TOTAL_SPENT. 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
FULFILLMENT_UNSUBMITTEDfilter 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...
Tags:
- Action Required
- Admin GraphQL API
- 2024-07
Product Feed variant images no longer fall back to product imageRead full post –>As of API version 2024-07, the variant image field in the
andwebhooks will no longer fall back to the product's first image when an image...Tags:
- Action Required
- Shopify App Store
Update on deprecation of unpublished appsRead full post –>Shopify requires all apps to pass App Store review for security and quality. Convert or sunset unpublished apps by the deadline to avoid API access revocation and uninstallation.
Tags:
- Platform
New timeout parameters for the Order Status PageRead full post –>Implemented level 2 data protection, new timeout parameters, and login requirements for Order Status Page. Include order numbers in SMS for enhanced security.
Tags:
- Admin GraphQL API
- 2024-04
Read full post –>Validation mutation endpoints now include optional title attributeTags:
- Admin GraphQL API
- 2024-04
New Location fields on GraphQL Admin APIRead full post –>As of version 2024-04 in the GraphQL Admin API, new fields
,, andhave been added to theLocationobject.Learn more about
Locationfields on...Tags:
- Action Required
- Admin GraphQL API
- Admin REST API
Level 2 protected customer data requirements are now needed to access theorder.statusPageUrlfieldRead full post –>Apps must meet Level 2 Protected Customer Data Requirements to access
on all Admin APIs. This may be a breaking change to enhance customer data protection.Tags:
- Tools
ui-save-barcomponent added to the latest version of App BridgeRead full post –>With the latest version of App Bridge, you can use the
ui-save-barcomponent and theReact component to declaratively control the contextual save bar, including settingloadingand...Tags:
- Tools
Modalsrcattribute added to the latest version of App BridgeRead full post –>With the latest version of App Bridge, you can use the
srcattribute with theui-modalcomponent and theModalReact component to display content from the provided URL. Learn more about it in...Tags:
- Admin GraphQL API
- 2024-04
Query retail cash tracking sessions with the GraphQL Admin APIRead full post –>Version 2024-04 adds GraphQL Admin API support for querying Shopify POS cash tracking sessions, providing data on transactions, staff actions, and discrepancies for POS Pro users.
Tags:
- Storefront GraphQL API
- 2024-04
Swatches and images for product filtersRead full post –>Version 2024-04 of the Storefront API introduces
,, andFilter.presentationfor enhanced visual filters. Requires Shopify's Search & Discovery app.Tags:
- API
POS UI Extensions 1.7 Update: Support for multiple cart discountsRead full post –>POS UI Extensions v1.7.0 adds
discountsto Cart,,APIs, andto List. Compatible with POS app v9.4.0.Tags:
- Admin GraphQL API
- 2024-04
FieldisGiftCardon all line item typesRead full post –>As of Admin GraphQL API version 2024-04, the
field that was present onandis now also present on:...
Tags:
- Shopify App Store
New Shopify App Store apps require the latest App BridgeRead full post –>As of March 13th, 2024, net new Shopify App Store apps must use the latest Shopify App Bridge by adding the
app-bridge.jsscript...Tags:
- Admin GraphQL API
- 2024-04
Customer Redaction support on Subscriptions APIsRead full post –>In Admin GraphQL API v2024-04, subscriptionContract mutations return CUSTOMER_REDACTED error for redacted customers, impacting subscription contract creation.
Tags:
- Liquid
New filter value swatch drop available, replacing the deprecated filter value's display dropRead full post –>Use the new Liquid swatch drop to create visual filters in themes. The filter value display drop is deprecated but remains functional for backward compatibility.
Tags:
- Storefront GraphQL API
- 2024-04
Delivery Groups now contain a group typeRead full post –>As of Storefront API's 2024-04 release, you can use
to determine whether a delivery group represents a single delivery (ONE_TIME_PURCHASE) or is a recurring...Tags:
- API
More data available in the checkout_completed customer eventRead full post –>You can now collect the id of a customer within the order object of the checkout_completed customer event. This gives you more customer insights to improve marketing campaign targeting and...
Tags:
- Tools
Clarifications in the Webhooks Reference docsRead full post –>- Clarified webhooks-related terminology in the Webhooks Overview page to make it easier to get started
- Updated accuracy of...
Tags:
- Platform
Hydrogen March 2024 releaseRead full post –>Hydrogen v2024.1.3 adds experimental Vite support, a new
command, GitHub PR comments for Oxygen, and upgrades to Remix v2.8, enhancing performance and stability.Tags:
- Shopify App Store
App submissions now require a screencast demoRead full post –>Developers must submit a video demo for app submissions, drafts, and relisting. This aids review teams in understanding app functionality, expediting the review process.