Shopify API deprecation tracker

Name: Shopify deprecation tracker
Creator: CommerceGeek

Every Shopify deprecation and removal we've reviewed: the version it goes in, the real deadline, what replaces it and the source it came from.

A removal in API version 2027-01 breaks your app when you upgrade to it; until then, older versions keep working until Shopify stops supporting them. That support end is the deadline we show, unless Shopify sets a date for everyone.

See also: supported API versions

Never miss one: subscribe to every deadline in your calendar (it updates itself, with a reminder two weeks before each). For Google Calendar, add this address under Other calendars → From URL: https://commercegeek.com/deprecations/calendar.ics

Last updated 2 Nov 2026

39 changes

Deprecation · Shopify FunctionsRemoved
API
Shopify Scripts will stop executing entirely on 30 June 2026, and editing or publishing new Scripts is no longer possible from 15 April 2026, so merchants and developers should migrate to Shopify Functions.
Deadline
30 Jun 2026Deadline set by Shopify
Days until
126 days ago
Announced
9 Apr 2026
Replacement
Shopify Functions
Source
Deprecation · Shopify CLIRemoved
Themes
From 23 September 2026, Shopify CLI versions 3.83.x and earlier will no longer support theme development workflows on password protected storefronts, so developers must upgrade the CLI.
Removed in
3.83.x and earlier
Deadline
23 Sept 2026Deadline set by Shopify
Days until
41 days ago
Announced
27 Aug 2026
Replacement
Shopify CLI 3.84.0 or later (latest recommended 4.7.0)
Source
Removal · Catalog APIs, MCP and AI ToolkitRemoved
Catalog
The Global Catalog REST API, deprecated in April 2026, stops serving traffic on 2 November 2026 and apps must migrate to Global Catalog MCP before then.
Deadline
2 Nov 2026Deadline set by Shopify
Days until
1 day ago
Announced
9 Oct 2026
Replacement
Global Catalog MCP (UCP tools: search_catalog, lookup_catalog, get_product)
Source
Removal · Checkout UI extensions, Customer Account APIAction required
Checkout UI extensions metafields
Checkout metafields can no longer be read or written in checkout and customer account UI extensions as of API version 2026-04, and developers must migrate to cart or order metafields.
Removed in
2026-04 (1 Apr 2026)
Deadline
16 Jan 2027When 2026-01, the last version with it, loses support
Days until
74 days
Announced
27 Apr 2026
Replacement
Cart metafields in checkout UI extensions and order metafields in customer account UI extensions
Add to calendar Source
Removal · Webhooks and eventsAction required
checkouts/create, checkouts/update, orders/cancelled, orders/create, orders/fulfilled, orders/link_requested, orders/paid, orders/partially_fulfilled, orders/updated webhooks
The id field was removed from checkout webhooks and the checkout_id field was removed from order webhooks, so handlers must switch to token or checkout_token.
Removed in
2026-04 (1 Apr 2026)
Deadline
16 Jan 2027When 2026-01, the last version with it, loses support
Days until
74 days
Announced
6 Mar 2026
Replacement
token (checkout webhooks) or checkout_token (order webhooks)
Add to calendar Source
Deprecation · Admin GraphQL API, Admin REST APIRemoval scheduled
scriptTagCreate, scriptTagUpdate mutations; ScriptTag REST resource (POST, PUT)
Script tags are deprecated: create and update operations return a user error from 1 October 2026, and Shopify stops injecting them into storefronts on 1 March 2027.
Deadline
1 Mar 2027Deadline set by Shopify
Days until
118 days
Announced
24 Aug 2026
Replacement
App embed blocks in a theme app extension; web pixels for analytics or conversion data
Add to calendar Source Article
Removal · OtherRemoval scheduled
Platform
Admin API requests using non-expiring offline access tokens will return HTTP 403 from 1 April 2027, and all public apps must migrate to expiring tokens by 1 January 2027.
Deadline
1 Apr 2027Deadline set by Shopify
Days until
149 days
Announced
27 Oct 2026
Replacement
Expiring offline access tokens
Add to calendar Source
Removal · Admin GraphQL APIRemoved in newer versions
MetaobjectFieldDefinition visibleToStorefrontApi field
The visibleToStorefrontApi field on metaobject field definitions is being removed from the unstable and 2026-07 Admin GraphQL API on 2 April 2026, so any queries or mutations referencing it must be updated.
Removed in
2026-07 (1 Jul 2026)
Deadline
16 Apr 2027When 2026-04, the last version with it, loses support
Days until
164 days
Announced
30 Mar 2026
Replacement
Storefront visibility controls on the access fields of the metaobject definition itself
Add to calendar Source
Removal · Admin GraphQL APIRemoved in newer versions
Admin GraphQL API
The grams field on DraftOrderLineItem is removed in API version 2026-07, so queries using it will error and should switch to the weight field.
Removed in
2026-07 (1 Jul 2026)
Deadline
16 Apr 2027When 2026-04, the last version with it, loses support
Days until
164 days
Announced
13 Apr 2026
Replacement
weight field on DraftOrderLineItem (returns value and unit)
Add to calendar Source
Removal · Admin GraphQL APIRemoved in newer versions
DraftOrderLineItem.grams
The grams field on DraftOrderLineItem is removed in API version 2026-07, so queries using it will fail and should switch to the weight field, which returns both value and unit.
Removed in
2026-07 (1 Jul 2026)
Deadline
16 Apr 2027When 2026-04, the last version with it, loses support
Days until
164 days
Announced
13 Apr 2026
Replacement
DraftOrderLineItem.weight
Add to calendar Source
Removal · Admin GraphQL APIRemoved in newer versions
inventorySetScheduledChanges
The inventorySetScheduledChanges mutation is being removed from the Admin GraphQL API in version 2026-07 with no replacement, so apps using it must stop relying on it.
Removed in
2026-07 (1 Jul 2026)
Deadline
16 Apr 2027When 2026-04, the last version with it, loses support
Days until
164 days
Announced
9 Mar 2026
Add to calendar Source
Deprecation · Admin GraphQL APIRemoved in newer versions
ShopifyQL
Several ShopifyQL Returns fields are deprecated in API version 2026-04 and replaced with renamed sales reversals fields, with deprecated fields removed in 2026-07.
Removed in
2026-07 (1 Jul 2026)
Deadline
16 Apr 2027When 2026-04, the last version with it, loses support
Days until
164 days
Announced
14 Mar 2026
Replacement
sales_reversals, net_sales_reversals, gross_sales_reversals, total_sales_reversals, discount_reversals, shipping_reversals, tax_reversals, reversed_quantity, reversed_quantity_rate, is_sales_reversal, order_or_sales_reversal
Add to calendar Source
Removal · Customer Account APIRemoved in newer versions
Customer.lastIncompleteCheckout and Checkout type subtree
The deprecated Customer.lastIncompleteCheckout field and the related Customer Account API Checkout type subtree are removed in version 2026-10, so apps querying them must update before upgrading.
Removed in
2026-10 (1 Oct 2026)
Deadline
16 Jul 2027When 2026-07, the last version with it, loses support
Days until
255 days
Announced
6 Jul 2026
Replacement
Storefront API cart flows for active cart or checkout state; Customer.orders for completed purchase history
Add to calendar Source
Removal · POS UI extensionsRemoved in newer versions
POS UI Extensions Session API
The static session.currentSession.staffMemberId field has been removed from the POS UI Extensions Session API in version 2026-10, so extensions targeting that version must read session.staffMember instead.
Removed in
2026-10 (1 Oct 2026)
Deadline
16 Jul 2027When 2026-07, the last version with it, loses support
Days until
255 days
Announced
17 Sept 2026
Replacement
session.staffMember.value?.id
Add to calendar Source
Removal · Admin GraphQL APIRemoved in newer versions
InventoryAdjustQuantities, InventoryMoveQuantities, InventorySetOnHandQuantities, InventorySetQuantitiesUserErrorCode
The ITEM_NOT_STOCKED_AT_LOCATION error code is removed from several inventory mutations and user error enums as of API version 2026-10, because inventory can now be adjusted at any location.
Removed in
2026-10 (1 Oct 2026)
Deadline
16 Jul 2027When 2026-07, the last version with it, loses support
Days until
255 days
Announced
19 Jun 2026
Add to calendar Source
Removal · Admin GraphQL APIRemoved in newer versions
DraftOrderDiscountNotAppliedWarning.priceRule
The deprecated priceRule field on DraftOrderDiscountNotAppliedWarning is removed in GraphQL Admin API version 2026-10, along with the PriceRule object from the public schema.
Removed in
2026-10 (1 Oct 2026)
Deadline
16 Jul 2027When 2026-07, the last version with it, loses support
Days until
255 days
Announced
23 Jun 2026
Replacement
discountTitle and discountCode fields on DraftOrderDiscountNotAppliedWarning
Add to calendar Source
Removal · Admin GraphQL APIRemoval scheduled
Collection source conditions (metafieldInteger)
The metafieldInteger collection source condition is removed from the Admin GraphQL API in version 2027-01, replaced by metafieldInt, whose value field is a String rather than an Int.
Removed in
2027-01 (1 Jan 2027)
Deadline
16 Oct 2027When 2026-10, the last version with it, loses support
Days until
347 days
Announced
1 Oct 2026
Replacement
metafieldInt
Add to calendar Source
Removal · Admin GraphQL APIRemoval scheduled
automaticDiscounts
The deprecated automaticDiscounts query is removed from the Admin GraphQL API in version 2027-01, so apps must move to discountNodes filtered by method:automatic before upgrading.
Removed in
2027-01 (1 Jan 2027)
Deadline
16 Oct 2027When 2026-10, the last version with it, loses support
Days until
347 days
Announced
18 Sept 2026
Replacement
discountNodes with query: "method:automatic"
Add to calendar Source Article
Removal · Admin GraphQL APIRemoval scheduled
marketCurrencySettingsUpdate
The marketCurrencySettingsUpdate mutation and its related payload and error types are removed in Admin GraphQL API version 2027-01, and developers should move currency settings handling to marketCreate and marketUpdate.
Removed in
2027-01 (1 Jan 2027)
Deadline
16 Oct 2027When 2026-10, the last version with it, loses support
Days until
347 days
Announced
22 Sept 2026
Replacement
marketCreate and marketUpdate
Add to calendar Source
Deprecation · Admin GraphQL APIRemoval scheduled
MetaobjectAdminAccess enum
The PRIVATE and PUBLIC_READ values of the MetaobjectAdminAccess enum on metaobject definitions are deprecated, are now obsolete and are never returned by the API.
Removed in
2027-01 (1 Jan 2027)
Deadline
16 Oct 2027When 2026-10, the last version with it, loses support
Days until
347 days
Announced
20 May 2026
Add to calendar Source
Deprecation · Admin GraphQL API, Customer Account APIAction required
CustomerPhoneNumber object
SMS marketing consent is now available through a new smsMarketingConsent field on CustomerPhoneNumber, and the existing flat SMS consent fields are deprecated.
Deadline
No date yet
Days until
No date yet
Announced
1 Oct 2026
Replacement
smsMarketingConsent field on CustomerPhoneNumber
Source
Deprecation · Admin GraphQL APIAction required
API
The isCumulative argument on the marketingEngagementCreate mutation is being deprecated, defaulting to false, so integrations should send non-cumulative engagements.
Deadline
No date yet
Days until
No date yet
Announced
1 Jul 2026
Replacement
Non-cumulative marketing engagements (omit or set isCumulative to false)
Source
Deprecation · Admin GraphQL APIAction required
ProductVariant.barcode
The ProductVariant.barcode field is deprecated in favour of a new barcodes connection that supports multiple typed barcodes per variant.
Deadline
No date yet
Days until
No date yet
Announced
8 Sept 2026
Replacement
ProductVariant.barcodes connection and barcodes input
Source
Removal · Admin GraphQL API, Shopify FunctionsAction required
Functions
The Discounts Allocator Function API developer preview has ended and the API has been removed, so apps declaring the purchase.discounts-allocator.run extension target must remove it to deploy.
Deadline
No date yet
Days until
No date yet
Announced
10 Sept 2026
Replacement
Discount Function API
Source
Deprecation · Admin GraphQL API, Shopify FunctionsAction required
Collection.ruleSet, collectionCreate(input:), collectionUpdate(input:)
The 2026-07 release replaces the single collection ruleSet with a multi-source model, deprecating Collection.ruleSet and the input argument on collectionCreate and collectionUpdate, and collections using the new features are filtered out of pre-2026-07 query results.
Deadline
No date yet
Days until
No date yet
Announced
17 Jun 2026
Replacement
Collection.sources and the collection argument on collectionCreate and collectionUpdate
Source
Deprecation · Admin GraphQL APIAction required
Admin GraphQL API delivery profile APIs (deliveryProfile, deliveryProfiles, deliveryProfilesCount, deliveryProfileLocationGroup, deliveryProfileLocationGroups, deliveryProfileCreate, deliveryProfileUpdate, deliveryProfileRemove)
Merchant-owned delivery profile APIs in the Admin GraphQL API are deprecated for shops using market-driven shipping, as reads may be stale and writes will not update live shipping settings.
Deadline
No date yet
Days until
No date yet
Announced
1 Jul 2026
Replacement
Contextual Product Feeds, app-owned delivery profiles, or Markets APIs, depending on use case
Source
Deprecation · Admin GraphQL APIDeprecated
deliveryShippingOriginAssign
The deliveryShippingOriginAssign mutation is deprecated in Admin GraphQL API version 2026-04 because legacy mode shipping profiles have been discontinued, and it will be removed in a future version.
Deadline
No date yet
Days until
No date yet
Announced
8 Jan 2026
Source
Removal · Admin REST APIDeprecated
pre_tax_price, pre_tax_price_set
The pre_tax_price and pre_tax_price_set fields on order line items in the REST Admin API are being removed, as they were only available to stores using the deprecated Avalara AvaTax 1.0 integration.
Deadline
No date yet
Days until
No date yet
Announced
23 Mar 2026
Replacement
GraphQL Admin API
Source
Deprecation · Checkout UI extensions, Shopify FunctionsAction required
useBuyerJourneyIntercept hook and block_progress capability on checkout UI extensions
The useBuyerJourneyIntercept hook and the block_progress capability on checkout UI extensions are deprecated from version 2026-07 and will be removed in a future version.
Deadline
No date yet
Days until
No date yet
Announced
2 Jul 2026
Replacement
Cart and checkout validation Functions; discount Function API for rejecting discount codes
Source
Deprecation · Customer Account API, Checkout UI extensionsDeprecated
API
The Customer Account API adds countryCode to customer address inputs and objects from version 2026-10, and territoryCode is deprecated but still fully supported.
Deadline
No date yet
Days until
No date yet
Announced
8 Sept 2026
Replacement
countryCode
Source
Removal · HydrogenAction required
ProductPayload.price; useCartActions (@shopify/hydrogen/vue)
Hydrogen 2026.10.0-preview.5 changes ProductPayload.price to a MoneyV2 object and removes the standalone useCartActions export from the Vue entry, both breaking changes requiring migration.
Removed in
2026.10.0-preview.5
Deadline
Removed in 2026.10.0-preview.5
Days until
No date yet
Announced
8 Oct 2026
Replacement
Pass variant price object instead of price.amount; use createCartComponents() useCartActions
Source
Removal · Hydrogen, Storefront API, Customer Account APIAction required
analytics.subscribe(), analytics.destroy(), EventPayloads, StorefrontApiError locations/path/extensions, standalone CartProvider/useCart/useCartActions/useCartForm, consent custom-banner setup
Hydrogen 2026.10.0-preview.4 removes several analytics, cart and error APIs, requires an async setup callback for custom-banner consent, and upgrades the Storefront and Customer Account API to version 2026-10 with deprecations such as territoryCode.
Removed in
2026.10.0-preview.4
Deadline
Removed in 2026.10.0-preview.4
Days until
No date yet
Announced
2 Oct 2026
Replacement
analytics.addDestination() with setup subscribe; createCartComponents(); AnalyticsEventMap[AnalyticsEventName]; result.errors extensions.code; consent custom-banner with setup callback
Source
Deprecation · HydrogenAction required
consent.sameDomainForStorefrontApi; Analytics.Provider cookieDomain prop; useShopifyCookies hasUserConsent, domain, ignoreDeprecatedCookies options; _shopify_y and _shopify_s cookies; Server-Timing headers; @shopify/remix-oxygen createRequestHandler
Hydrogen now relies on the Customer Privacy API for visitor tracking and consent, requiring a same-origin Storefront API proxy and deprecating several cookie and consent options.
Deadline
No date yet
Days until
No date yet
Announced
29 Sept 2026
Replacement
Hydrogen createRequestHandler from @shopify/hydrogen or @shopify/hydrogen/oxygen; Customer Privacy API for cookie lifecycle; customerPrivacy API returned by useCustomerPrivacy
Source
Deprecation · MCP and AI ToolkitAction required
API
The get_cart and update_cart tools on the Storefront MCP server are deprecated in favour of the UCP-conforming Cart MCP tools, and the deprecated tools will be maintained until 31 August 2026.
Deadline
No date yet
Days until
No date yet
Announced
24 Jun 2026
Replacement
Cart MCP tools (create_cart, get_cart, update_cart, cancel_cart) at https://{shop-domain}/api/ucp/mcp
Source
Deprecation · MCP and AI Toolkit, Catalog APIsAction required
Storefront Catalog MCP search and lookup tools
The Storefront Catalog MCP now implements UCP, deprecating the previous search and lookup tools in favour of new tool names, a new endpoint and updated request and response shapes, with the old versions maintained until 15 June 2026.
Deadline
No date yet
Days until
No date yet
Announced
22 Apr 2026
Replacement
search_catalog, lookup_catalog and get_product tools at https://{storedomain}/api/ucp/mcp
Source
Removal · Shopify CLIAction required
Shopify CLI 4.0 command and flag removals (shopify app deploy, shopify app release, shopify app generate extension, shopify app webhook trigger, shopify theme serve)
Shopify CLI 4.0.0 removes several deprecated flags and commands, including --force from app deploy and app release, and drops Node 20 support, while also adopting semantic versioning and automatic self-upgrades.
Removed in
4.0.0
Deadline
Removed in 4.0.0
Days until
No date yet
Announced
21 May 2026
Replacement
--allow-updates (with --allow-deletes where needed) for --force; --template for --type; shopify app function schema for shopify app generate schema; shopify app generate extension for shopify app scaffold extension; shopify app webhook trigger for top-level webhook trigger; --client-secret for --shared-secret; shopify theme dev for theme serve
Source
Deprecation · Shopify CLIAction required
`--force` flag on the `shopify app deploy` and `shopify app release` commands
The --force flag on shopify app deploy and shopify app release is deprecated and will be removed in a Shopify CLI release in May 2026.
Deadline
No date yet
Days until
No date yet
Announced
25 Mar 2026
Replacement
--allow-updates flag (and --allow-deletes for extension deletions)
Source
Deprecation · Storefront APIDeprecated
Storefront API cart discount fields (cart.discountAllocations, cartDiscountAllocation.discountApplication)
Storefront API 2026-07 deprecates cart.discountAllocations and cartDiscountAllocation.discountApplication, adds replacement discount fields, and fixes an incorrect per-line value on discountApplication.
Deadline
No date yet
Days until
No date yet
Announced
10 Apr 2026
Replacement
cart.discountApplications, cart.lines[].discountAllocations(lineLevelOnly: false), cart.deliveryGroups[].discountAllocations, cartDiscountAllocation.sourceDiscountApplication
Source
Deprecation · Catalog APIs, MCP and AI ToolkitAction required
Storefront Catalog MCP tools and endpoint
The Storefront Catalog MCP now implements UCP with new tool names and endpoint, and the previous search and lookup tools are deprecated.
Deadline
No date yet
Days until
No date yet
Announced
22 Apr 2026
Replacement
search_catalog, lookup_catalog, get_product at https://{storedomain}/api/ucp/mcp
Source

Shopify deprecations and changes
Change	Versions	Deadline	Days until	Status	Links
Deprecation · Shopify FunctionsAPIShopify Scripts will stop executing entirely on 30 June 2026, and editing or publishing new Scripts is no longer possible from 15 April 2026, so merchants and developers should migrate to Shopify Functions.Use instead: Shopify FunctionsAnnounced 9 Apr 2026	2026-04 → ?	30 Jun 2026Deadline set by Shopify	126 days ago	Removed	Source
Deprecation · Shopify CLIThemesFrom 23 September 2026, Shopify CLI versions 3.83.x and earlier will no longer support theme development workflows on password protected storefronts, so developers must upgrade the CLI.Use instead: Shopify CLI 3.84.0 or later (latest recommended 4.7.0)Announced 27 Aug 2026	– → 3.83.x and earlierBreaks from 3.83.x and earlier	23 Sept 2026Deadline set by Shopify	41 days ago	Removed	Source
Removal · Catalog APIs, MCP and AI ToolkitCatalogThe Global Catalog REST API, deprecated in April 2026, stops serving traffic on 2 November 2026 and apps must migrate to Global Catalog MCP before then.Use instead: Global Catalog MCP (UCP tools: search_catalog, lookup_catalog, get_product)Announced 9 Oct 2026	April 2026 → ?	2 Nov 2026Deadline set by Shopify	1 day ago	Removed	Source
Removal · Checkout UI extensions, Customer Account APICheckout UI extensions metafieldsCheckout metafields can no longer be read or written in checkout and customer account UI extensions as of API version 2026-04, and developers must migrate to cart or order metafields.Use instead: Cart metafields in checkout UI extensions and order metafields in customer account UI extensionsAnnounced 27 Apr 2026	2026-04 → 2026-04Breaks from 2026-04 (1 Apr 2026)	16 Jan 2027When 2026-01, the last version with it, loses support	74 days	Action required	Add to calendar Source
Removal · Webhooks and eventscheckouts/create, checkouts/update, orders/cancelled, orders/create, orders/fulfilled, orders/link_requested, orders/paid, orders/partially_fulfilled, orders/updated webhooksThe id field was removed from checkout webhooks and the checkout_id field was removed from order webhooks, so handlers must switch to token or checkout_token.Use instead: token (checkout webhooks) or checkout_token (order webhooks)Announced 6 Mar 2026	2026-04 → 2026-04Breaks from 2026-04 (1 Apr 2026)	16 Jan 2027When 2026-01, the last version with it, loses support	74 days	Action required	Add to calendar Source
Deprecation · Admin GraphQL API, Admin REST APIscriptTagCreate, scriptTagUpdate mutations; ScriptTag REST resource (POST, PUT)Script tags are deprecated: create and update operations return a user error from 1 October 2026, and Shopify stops injecting them into storefronts on 1 March 2027.Use instead: App embed blocks in a theme app extension; web pixels for analytics or conversion dataAnnounced 24 Aug 2026	– → ?	1 Mar 2027Deadline set by Shopify	118 days	Removal scheduled	Add to calendar Source Article
Removal · OtherPlatformAdmin API requests using non-expiring offline access tokens will return HTTP 403 from 1 April 2027, and all public apps must migrate to expiring tokens by 1 January 2027.Use instead: Expiring offline access tokensAnnounced 27 Oct 2026	– → ?	1 Apr 2027Deadline set by Shopify	149 days	Removal scheduled	Add to calendar Source
Removal · Admin GraphQL APIMetaobjectFieldDefinition visibleToStorefrontApi fieldThe visibleToStorefrontApi field on metaobject field definitions is being removed from the unstable and 2026-07 Admin GraphQL API on 2 April 2026, so any queries or mutations referencing it must be updated.Use instead: Storefront visibility controls on the access fields of the metaobject definition itselfAnnounced 30 Mar 2026	2026-07 → 2026-07Breaks from 2026-07 (1 Jul 2026)	16 Apr 2027When 2026-04, the last version with it, loses support	164 days	Removed in newer versions	Add to calendar Source
Removal · Admin GraphQL APIAdmin GraphQL APIThe grams field on DraftOrderLineItem is removed in API version 2026-07, so queries using it will error and should switch to the weight field.Use instead: weight field on DraftOrderLineItem (returns value and unit)Announced 13 Apr 2026	2026-07 → 2026-07Breaks from 2026-07 (1 Jul 2026)	16 Apr 2027When 2026-04, the last version with it, loses support	164 days	Removed in newer versions	Add to calendar Source
Removal · Admin GraphQL APIDraftOrderLineItem.gramsThe grams field on DraftOrderLineItem is removed in API version 2026-07, so queries using it will fail and should switch to the weight field, which returns both value and unit.Use instead: DraftOrderLineItem.weightAnnounced 13 Apr 2026	2026-07 → 2026-07Breaks from 2026-07 (1 Jul 2026)	16 Apr 2027When 2026-04, the last version with it, loses support	164 days	Removed in newer versions	Add to calendar Source
Removal · Admin GraphQL APIinventorySetScheduledChangesThe inventorySetScheduledChanges mutation is being removed from the Admin GraphQL API in version 2026-07 with no replacement, so apps using it must stop relying on it.Announced 9 Mar 2026	2026-07 → 2026-07Breaks from 2026-07 (1 Jul 2026)	16 Apr 2027When 2026-04, the last version with it, loses support	164 days	Removed in newer versions	Add to calendar Source
Deprecation · Admin GraphQL APIShopifyQLSeveral ShopifyQL Returns fields are deprecated in API version 2026-04 and replaced with renamed sales reversals fields, with deprecated fields removed in 2026-07.Use instead: sales_reversals, net_sales_reversals, gross_sales_reversals, total_sales_reversals, discount_reversals, shipping_reversals, tax_reversals, reversed_quantity, reversed_quantity_rate, is_sales_reversal, order_or_sales_reversalAnnounced 14 Mar 2026	2026-04 → 2026-07Breaks from 2026-07 (1 Jul 2026)	16 Apr 2027When 2026-04, the last version with it, loses support	164 days	Removed in newer versions	Add to calendar Source
Removal · Customer Account APICustomer.lastIncompleteCheckout and Checkout type subtreeThe deprecated Customer.lastIncompleteCheckout field and the related Customer Account API Checkout type subtree are removed in version 2026-10, so apps querying them must update before upgrading.Use instead: Storefront API cart flows for active cart or checkout state; Customer.orders for completed purchase historyAnnounced 6 Jul 2026	2026-10 → 2026-10Breaks from 2026-10 (1 Oct 2026)	16 Jul 2027When 2026-07, the last version with it, loses support	255 days	Removed in newer versions	Add to calendar Source
Removal · POS UI extensionsPOS UI Extensions Session APIThe static session.currentSession.staffMemberId field has been removed from the POS UI Extensions Session API in version 2026-10, so extensions targeting that version must read session.staffMember instead.Use instead: session.staffMember.value?.idAnnounced 17 Sept 2026	2026-07 → 2026-10Breaks from 2026-10 (1 Oct 2026)	16 Jul 2027When 2026-07, the last version with it, loses support	255 days	Removed in newer versions	Add to calendar Source
Removal · Admin GraphQL APIInventoryAdjustQuantities, InventoryMoveQuantities, InventorySetOnHandQuantities, InventorySetQuantitiesUserErrorCodeThe ITEM_NOT_STOCKED_AT_LOCATION error code is removed from several inventory mutations and user error enums as of API version 2026-10, because inventory can now be adjusted at any location.Announced 19 Jun 2026	2026-10 → 2026-10Breaks from 2026-10 (1 Oct 2026)	16 Jul 2027When 2026-07, the last version with it, loses support	255 days	Removed in newer versions	Add to calendar Source
Removal · Admin GraphQL APIDraftOrderDiscountNotAppliedWarning.priceRuleThe deprecated priceRule field on DraftOrderDiscountNotAppliedWarning is removed in GraphQL Admin API version 2026-10, along with the PriceRule object from the public schema.Use instead: discountTitle and discountCode fields on DraftOrderDiscountNotAppliedWarningAnnounced 23 Jun 2026	2026-10 → 2026-10Breaks from 2026-10 (1 Oct 2026)	16 Jul 2027When 2026-07, the last version with it, loses support	255 days	Removed in newer versions	Add to calendar Source
Removal · Admin GraphQL APICollection source conditions (metafieldInteger)The metafieldInteger collection source condition is removed from the Admin GraphQL API in version 2027-01, replaced by metafieldInt, whose value field is a String rather than an Int.Use instead: metafieldIntAnnounced 1 Oct 2026	2027-01 → 2027-01Breaks from 2027-01 (1 Jan 2027)	16 Oct 2027When 2026-10, the last version with it, loses support	347 days	Removal scheduled	Add to calendar Source
Removal · Admin GraphQL APIautomaticDiscountsThe deprecated automaticDiscounts query is removed from the Admin GraphQL API in version 2027-01, so apps must move to discountNodes filtered by method:automatic before upgrading.Use instead: discountNodes with query: "method:automatic"Announced 18 Sept 2026	2027-01 → 2027-01Breaks from 2027-01 (1 Jan 2027)	16 Oct 2027When 2026-10, the last version with it, loses support	347 days	Removal scheduled	Add to calendar Source Article
Removal · Admin GraphQL APImarketCurrencySettingsUpdateThe marketCurrencySettingsUpdate mutation and its related payload and error types are removed in Admin GraphQL API version 2027-01, and developers should move currency settings handling to marketCreate and marketUpdate.Use instead: marketCreate and marketUpdateAnnounced 22 Sept 2026	2025-04 → 2027-01Breaks from 2027-01 (1 Jan 2027)	16 Oct 2027When 2026-10, the last version with it, loses support	347 days	Removal scheduled	Add to calendar Source
Deprecation · Admin GraphQL APIMetaobjectAdminAccess enumThe PRIVATE and PUBLIC_READ values of the MetaobjectAdminAccess enum on metaobject definitions are deprecated, are now obsolete and are never returned by the API.Announced 20 May 2026	2027-01 → 2027-01Breaks from 2027-01 (1 Jan 2027)	16 Oct 2027When 2026-10, the last version with it, loses support	347 days	Removal scheduled	Add to calendar Source
Deprecation · Admin GraphQL API, Customer Account APICustomerPhoneNumber objectSMS marketing consent is now available through a new smsMarketingConsent field on CustomerPhoneNumber, and the existing flat SMS consent fields are deprecated.Use instead: smsMarketingConsent field on CustomerPhoneNumberAnnounced 1 Oct 2026	2026-10 → ?	No date yet	No date yet	Action required	Source
Deprecation · Admin GraphQL APIAPIThe isCumulative argument on the marketingEngagementCreate mutation is being deprecated, defaulting to false, so integrations should send non-cumulative engagements.Use instead: Non-cumulative marketing engagements (omit or set isCumulative to false)Announced 1 Jul 2026	2026-07 → ?	No date yet	No date yet	Action required	Source
Deprecation · Admin GraphQL APIProductVariant.barcodeThe ProductVariant.barcode field is deprecated in favour of a new barcodes connection that supports multiple typed barcodes per variant.Use instead: ProductVariant.barcodes connection and barcodes inputAnnounced 8 Sept 2026	2026-10 → ?	No date yet	No date yet	Action required	Source
Removal · Admin GraphQL API, Shopify FunctionsFunctionsThe Discounts Allocator Function API developer preview has ended and the API has been removed, so apps declaring the purchase.discounts-allocator.run extension target must remove it to deploy.Use instead: Discount Function APIAnnounced 10 Sept 2026	– → ?	No date yet	No date yet	Action required	Source
Deprecation · Admin GraphQL API, Shopify FunctionsCollection.ruleSet, collectionCreate(input:), collectionUpdate(input:)The 2026-07 release replaces the single collection ruleSet with a multi-source model, deprecating Collection.ruleSet and the input argument on collectionCreate and collectionUpdate, and collections using the new features are filtered out of pre-2026-07 query results.Use instead: Collection.sources and the collection argument on collectionCreate and collectionUpdateAnnounced 17 Jun 2026	2026-07 → ?	No date yet	No date yet	Action required	Source
Deprecation · Admin GraphQL APIAdmin GraphQL API delivery profile APIs (deliveryProfile, deliveryProfiles, deliveryProfilesCount, deliveryProfileLocationGroup, deliveryProfileLocationGroups, deliveryProfileCreate, deliveryProfileUpdate, deliveryProfileRemove)Merchant-owned delivery profile APIs in the Admin GraphQL API are deprecated for shops using market-driven shipping, as reads may be stale and writes will not update live shipping settings.Use instead: Contextual Product Feeds, app-owned delivery profiles, or Markets APIs, depending on use caseAnnounced 1 Jul 2026	2026-07 → ?	No date yet	No date yet	Action required	Source
Deprecation · Admin GraphQL APIdeliveryShippingOriginAssignThe deliveryShippingOriginAssign mutation is deprecated in Admin GraphQL API version 2026-04 because legacy mode shipping profiles have been discontinued, and it will be removed in a future version.Announced 8 Jan 2026	2026-04 → ?	No date yet	No date yet	Deprecated	Source
Removal · Admin REST APIpre_tax_price, pre_tax_price_setThe pre_tax_price and pre_tax_price_set fields on order line items in the REST Admin API are being removed, as they were only available to stores using the deprecated Avalara AvaTax 1.0 integration.Use instead: GraphQL Admin APIAnnounced 23 Mar 2026	– → ?	No date yet	No date yet	Deprecated	Source
Deprecation · Checkout UI extensions, Shopify FunctionsuseBuyerJourneyIntercept hook and block_progress capability on checkout UI extensionsThe useBuyerJourneyIntercept hook and the block_progress capability on checkout UI extensions are deprecated from version 2026-07 and will be removed in a future version.Use instead: Cart and checkout validation Functions; discount Function API for rejecting discount codesAnnounced 2 Jul 2026	2026-07 → ?	No date yet	No date yet	Action required	Source
Deprecation · Customer Account API, Checkout UI extensionsAPIThe Customer Account API adds countryCode to customer address inputs and objects from version 2026-10, and territoryCode is deprecated but still fully supported.Use instead: countryCodeAnnounced 8 Sept 2026	2026-10 → ?	No date yet	No date yet	Deprecated	Source
Removal · HydrogenProductPayload.price; useCartActions (@shopify/hydrogen/vue)Hydrogen 2026.10.0-preview.5 changes ProductPayload.price to a MoneyV2 object and removes the standalone useCartActions export from the Vue entry, both breaking changes requiring migration.Use instead: Pass variant price object instead of price.amount; use createCartComponents() useCartActionsAnnounced 8 Oct 2026	– → 2026.10.0-preview.5Breaks from 2026.10.0-preview.5	Removed in 2026.10.0-preview.5	No date yet	Action required	Source
Removal · Hydrogen, Storefront API, Customer Account APIanalytics.subscribe(), analytics.destroy(), EventPayloads, StorefrontApiError locations/path/extensions, standalone CartProvider/useCart/useCartActions/useCartForm, consent custom-banner setupHydrogen 2026.10.0-preview.4 removes several analytics, cart and error APIs, requires an async setup callback for custom-banner consent, and upgrades the Storefront and Customer Account API to version 2026-10 with deprecations such as territoryCode.Use instead: analytics.addDestination() with setup subscribe; createCartComponents(); AnalyticsEventMap[AnalyticsEventName]; result.errors extensions.code; consent custom-banner with setup callbackAnnounced 2 Oct 2026	– → 2026.10.0-preview.4Breaks from 2026.10.0-preview.4	Removed in 2026.10.0-preview.4	No date yet	Action required	Source
Deprecation · Hydrogenconsent.sameDomainForStorefrontApi; Analytics.Provider cookieDomain prop; useShopifyCookies hasUserConsent, domain, ignoreDeprecatedCookies options; _shopify_y and _shopify_s cookies; Server-Timing headers; @shopify/remix-oxygen createRequestHandlerHydrogen now relies on the Customer Privacy API for visitor tracking and consent, requiring a same-origin Storefront API proxy and deprecating several cookie and consent options.Use instead: Hydrogen createRequestHandler from @shopify/hydrogen or @shopify/hydrogen/oxygen; Customer Privacy API for cookie lifecycle; customerPrivacy API returned by useCustomerPrivacyAnnounced 29 Sept 2026	2026.4.4 → ?	No date yet	No date yet	Action required	Source
Deprecation · MCP and AI ToolkitAPIThe get_cart and update_cart tools on the Storefront MCP server are deprecated in favour of the UCP-conforming Cart MCP tools, and the deprecated tools will be maintained until 31 August 2026.Use instead: Cart MCP tools (create_cart, get_cart, update_cart, cancel_cart) at https://{shop-domain}/api/ucp/mcpAnnounced 24 Jun 2026	2026-06-24 → ?	No date yet	No date yet	Action required	Source
Deprecation · MCP and AI Toolkit, Catalog APIsStorefront Catalog MCP search and lookup toolsThe Storefront Catalog MCP now implements UCP, deprecating the previous search and lookup tools in favour of new tool names, a new endpoint and updated request and response shapes, with the old versions maintained until 15 June 2026.Use instead: search_catalog, lookup_catalog and get_product tools at https://{storedomain}/api/ucp/mcpAnnounced 22 Apr 2026	2026-04-22 → ?	No date yet	No date yet	Action required	Source
Removal · Shopify CLIShopify CLI 4.0 command and flag removals (shopify app deploy, shopify app release, shopify app generate extension, shopify app webhook trigger, shopify theme serve)Shopify CLI 4.0.0 removes several deprecated flags and commands, including --force from app deploy and app release, and drops Node 20 support, while also adopting semantic versioning and automatic self-upgrades.Use instead: --allow-updates (with --allow-deletes where needed) for --force; --template for --type; shopify app function schema for shopify app generate schema; shopify app generate extension for shopify app scaffold extension; shopify app webhook trigger for top-level webhook trigger; --client-secret for --shared-secret; shopify theme dev for theme serveAnnounced 21 May 2026	– → 4.0.0Breaks from 4.0.0	Removed in 4.0.0	No date yet	Action required	Source
Deprecation · Shopify CLI`--force` flag on the `shopify app deploy` and `shopify app release` commandsThe --force flag on shopify app deploy and shopify app release is deprecated and will be removed in a Shopify CLI release in May 2026.Use instead: --allow-updates flag (and --allow-deletes for extension deletions)Announced 25 Mar 2026	March 2026 → ?	No date yet	No date yet	Action required	Source
Deprecation · Storefront APIStorefront API cart discount fields (cart.discountAllocations, cartDiscountAllocation.discountApplication)Storefront API 2026-07 deprecates cart.discountAllocations and cartDiscountAllocation.discountApplication, adds replacement discount fields, and fixes an incorrect per-line value on discountApplication.Use instead: cart.discountApplications, cart.lines[].discountAllocations(lineLevelOnly: false), cart.deliveryGroups[].discountAllocations, cartDiscountAllocation.sourceDiscountApplicationAnnounced 10 Apr 2026	2026-07 → ?	No date yet	No date yet	Deprecated	Source
Deprecation · Catalog APIs, MCP and AI ToolkitStorefront Catalog MCP tools and endpointThe Storefront Catalog MCP now implements UCP with new tool names and endpoint, and the previous search and lookup tools are deprecated.Use instead: search_catalog, lookup_catalog, get_product at https://{storedomain}/api/ucp/mcpAnnounced 22 Apr 2026	– → ?	No date yet	No date yet	Action required	Source

Deadlines come from the source, or from Shopify's version support dates. Announcement dates are never used as deadlines.

Get alerts for your stack (coming soon)

Tell us what you build on and we'll let you know when alerts for the APIs and packages you use are ready.