Shopify Merchant Deadline Tracker
Shopify ships changes as a stream — never as a calendar. This page consolidates every change with a date attached that costs merchants money or breaks stores, with the columns Shopify doesn't publish: whether you are affected, what happens if you do nothing, and when it's safe to ignore. Maintained by Electric Enjin; every row carries a last-verified date.
Invalid metafield queries start returning errors (GraphQL Admin API 2026-10)
Deadline: October 1, 2026 · Severity: high · API version: 2026-10
Who is affected: Stores with custom apps, private integrations, or headless builds that query metafields through the Admin GraphQL API.
60-second self-check: Ask whoever built your custom app or integration whether it queries metafields and which API version it targets. If everything on your store is off-the-shelf public apps, this is your app developers' problem, not yours.
What breaks if you ignore it: Once an integration moves to API version 2026-10, previously-silent invalid metafield queries throw errors — syncs, dashboards, or custom features that depend on them stop working.
Effort: 1–4 developer hours to audit and correct queries; zero if you have no custom integrations.
Our verdict: Act only if you have custom-built integrations. Off-the-shelf app users: no action — your vendors handle it.
Last verified 2026-08-13
API version 2025-10 reaches end of support
Deadline: October 1, 2026 · Severity: medium · API version: 2025-10
Who is affected: Stores running custom apps or integrations pinned to Admin/Storefront API version 2025-10 (Shopify supports each quarterly version for 12 months).
60-second self-check: List your custom/private apps (Admin → Settings → Apps and sales channels → Develop apps) and ask each maintainer which API version it requests. Public App Store apps manage this themselves.
What breaks if you ignore it: Requests to a retired version are served by the oldest supported version instead — behavior can change silently, and anything relying on since-changed fields can break without an error email.
Effort: Typically 2–8 developer hours per custom app to bump the version and test.
Our verdict: Schedule the upgrade for September; do not wait for breakage — the failure mode is silent.
Last verified 2026-08-13
API version 2026-01 reaches end of support
Deadline: January 1, 2027 · Severity: low · API version: 2026-01
Who is affected: Stores with custom apps pinned to API version 2026-01.
60-second self-check: Same check as the 2025-10 row — ask your app maintainers which version they target.
What breaks if you ignore it: Same silent-fallback behavior as every version sunset.
Effort: Typically 2–8 developer hours per custom app.
Our verdict: No action needed yet — calendar it for December 2026. We list it so you are not surprised.
Last verified 2026-08-13
Every important Shopify update — last 6 months
Action-required items, breaking changes, and deprecations from Shopify's merchant and developer changelogs, newest first.
- 2026-08-27 · Action required — Password Protected Shop Dev flows on Shopify Theme CLI v3.83.x and older to be deprecated
Starting October 1, 2026, Theme commands on Shopify CLI for password protected storefronts will require version 3.84.0 or later . Versions 3.83.x and earlier will no longer be supported for theme development workflows on - 2026-08-24 · Action required — Script tags are deprecated and will stop running on March 1, 2027
Starting October 1, 2026, the scriptTagCreate and scriptTagUpdate mutations will return an user error, and the ScriptTag REST Admin API resource will reject POST and PUT . The deprecation applies to all API versions, inc - 2026-07-24 · Action required · API 2026-10 — Invalid metafield queries now return errors in the GraphQL Admin API
Starting in API version 2026-10, the GraphQL Admin API returns an error when a query filters by a metafield that isn't set up for filtering, instead of silently returning incorrect results. This is a breaking change. It - 2026-07-09 · Action required — Identity verification for Shopify Partners starts today
Trust is foundational to the Shopify Partner ecosystem. Partners take actions across Shopify that can directly affect merchants, and merchants need confidence when granting access to their stores. We’re introducing ident - 2026-07-08 · Action required · API 2026-07 — POS UI extensions 2026-07 uses per-unit fixed-amount line item discounts
Starting with POS UI extensions API version 2026-07, FixedAmount line item discounts passed to setLineItemDiscount and bulkSetLineItemDiscounts from the Cart API must represent a per-unit discount. Why it's changing In A - 2026-07-06 · Action required · API 2026-10 — Customer Account API Customer.lastIncompleteCheckout and Checkout types removed in 2026-10
As of Customer Account API version 2026-10, the deprecated Customer.lastIncompleteCheckout field is removed. This also removes the now-unreachable Customer Account API Checkout type subtree, including: Checkout Checkout. - 2026-07-02 · Action required · API 2026-07 — Deprecating the useBuyerJourneyIntercept API on checkout UI extensions
Starting in version 2026-07 , the useBuyerJourneyIntercept hook on checkout UI extensions, and the block_progress capability it depends on, are deprecated. Existing extensions will continue to work on current and prior A - 2026-07-01 · Action required · API 2026-07 — Market-driven shipping now available in feature preview
Market-driven shipping moves merchant-owned shipping configuration out of delivery profiles and into Markets. Merchants will attach shipping options directly to each market, and then vary rates by product and location co - 2026-07-01 · Action required · API 2026-07 — Deprecation of cumulative marketing engagements
The isCumulative argument to the marketingEngagementCreate mutation is being deprecated, defaulting to false . Please update your integration to send non-cumulative engagements, as needed. Existing activities that have b - 2026-07-01 · Deprecation · API 2026-07 — `discountedUnitPrice` on `DraftOrderLineItem` Customer Account API deprecation
The discountedUnitPrice field on the DraftOrderLineItem object in the Customer Account API is now deprecated. Use approximateDiscountedUnitPrice instead. This new field calculates the discounted total divided by the quan - 2026-07-01 · Action required · API 2026-07 — Merchant-owned delivery profile APIs are deprecated for market-driven shipping
What's changing We’re moving merchant-owned shipping configuration from legacy delivery profiles to Markets as part of market-driven shipping, a new model where shipping is configured per Market. When a shop uses market- - 2026-06-26 · Breaking change · API 2026-10 — Carrier services will no longer be automatically added to the default shipping profile
Starting with GraphQL Admin API version 2026-10, creating a carrier service no longer automatically adds it to the shop’s General shipping profile. This breaking change affects carrier services created using: GraphQL Adm - 2026-06-24 · Action required — Storefront MCP cart tools are being deprecated in favour of UCP Cart MCP
What's changing The cart tools on the Storefront MCP server are being deprecated in favour of the UCP-conforming Cart MCP tools: get_cart and update_cart on https://{shop}.myshopify.com/api/mcp are deprecated. Cart MCP i - 2026-06-23 · Action required · API 2026-10 — `DraftOrderDiscountNotAppliedWarning.priceRule` removed in GraphQL Admin API 2026-10
Starting with GraphQL Admin API version 2026-10 , the deprecated priceRule field on the DraftOrderDiscountNotAppliedWarning object is removed. This is a breaking change for apps that query priceRule on DraftOrderDiscount - 2026-06-19 · Action required · API 2026-10 — Removal of ITEM_NOT_STOCKED_AT_LOCATION error
The ITEM_NOT_STOCKED_AT_LOCATION error will be removed from InventoryAdjustQuantities , InventoryMoveQuantities , InventorySetOnHandQuantities , and InventorySetQuantitiesUserErrorCode as of API version 2026-10. Followin - 2026-06-17 · Action required · API 2026-07 — WhatsApp marketing consent now available in the Admin API and Customer Account API
WhatsApp marketing consent can now be managed through both the Customer Account and Admin APIs. Use the customerWhatsAppMarketingConsentUpdate mutation to update a customer’s WhatsApp marketing consent status for their d - 2026-06-17 · Action required — Built for Shopify requirements for Returns and exchanges apps and Subscription apps (effective December 1, 2026)
Effective December 1, 2026 , Returns and exchanges apps and Subscription apps that provide buyer-facing self-service experiences must authenticate customers using the Customer Account API. Apps that don't meet this requi - 2026-06-17 · Action required · API 2026-07 — New Collection model and APIs now available
The 2026-07 release replaces a collection’s single ruleSet with a multi-source model in the GraphQL Admin API. Each collection now has one or more CollectionSource objects that define typed inclusion and exclusion condit - 2026-06-16 · Action required — Metafields now require a definition to be accessed through the Customer Account API
Starting today, metafields stored on the app resource must have a metafield definition and customer accounts permissions to be accessible through the Customer Account API. Going forward, when calling the Customer Account - 2026-06-11 · Action required — Shopify AI Toolkit for upgrading extensions to Polaris web components
The Shopify AI Toolkit now supports upgrading checkout and customer account UI extensions to new API versions, including the migration to Polaris web components. Use the AI Toolkit with your preferred AI coding agent to - 2026-05-21 · Deprecation — Shopify CLI 4.0: SemVer, auto-updates, removing deprecated flags and commands
The release of Shopify CLI 4.0 today brings clarity to CLI versioning, the introduction of automatic updates, and the announced removal of the deprecated --force flag from shopify app deploy . Semantic Versioning Shopify - 2026-05-20 · Deprecation · API 2027-01 — Removing deprecated PRIVATE and PUBLIC_READ enums on metaobject definitions
We are updating the MetaobjectAdminAccess enum by deprecating the PRIVATE and PUBLIC_READ values. These values are now obsolete and are never returned by the API. This change removes ambiguity, as the deprecated access v - 2026-05-20 · Action required — Expiring offline access tokens required for all public apps as of January 1, 2027
We're changing how public apps handle offline access tokens to enhance merchant data protection. Starting January 1, 2027, all public apps must use expiring offline access tokens when calling the Admin API. After that da - 2026-05-07 · Deprecation — Benchmark Comparisons in Analytics will be removed on May 19th
Benchmark Comparison data in Shopify Analytics will no longer show new data, and the feature will be fully removed on May 19, 2026 . Alternatives: Use Metric Targets to set and track your own performance targets directly - 2026-05-07 · Action required — Bots and agents should identify themselves via Web Bot Auth
What's changing Shopify now applies stricter rate limits to bots and agents that access the Storefront API and Shopify-hosted online store pages. Bots and agents that don't sign their requests are subject to the strictes - 2026-05-06 · Action required — App deployment in CI/CD is now available for all apps
App deployment in CI/CD is now available for all apps through app automation tokens on the Dev Dashboard. These tokens offer app-scoped authentication, allowing you to use the latest Shopify CLI to automate app releases - 2026-05-06 · Action required — Ship and pickup in one order now available in feature preview
Shopify Plus and Enterprise merchants will soon be able to enable a single checkout experience where customers can choose both shipping and store pickup within the same order. Previously, customers had to place separate - 2026-04-27 · Action required · API 2026-04 — Deprecation of checkout metafields in checkout and customer account UI extensions
As of API version 2026-04, the ability to read and write checkout metafields in checkout and customer account UI extensions has been removed. Instead, checkout metafields have been replaced by cart metafields in checkout - 2026-04-24 · Breaking change — `totalUnsettledSet` calculation fixed for pending captures
The totalUnsettledSet field on the OrderTransaction object now correctly calculates the unsettled amount when a capture is in pending status. The affected field is OrderTransaction.totalUnsettledSet . What's changed Prev - 2026-04-23 · Action required — Automatic CSS subsetting for `{% stylesheet %}` tags
Shopify is introducing CSS content subsetting for {% stylesheet %} tags to improve storefront performance. Starting April 20, 2026, Shopify only delivers the CSS from {% stylesheet %} tags that are relevant to the sectio - 2026-04-22 · Action required — Storefront Catalog MCP now implements UCP
What’s changing The following UCP catalog tools in Storefront Catalog are now available: - `search_catalog`: Search a store's product catalog with filters, pagination, and buyer context - `lookup_catalog`: Batch lookup p - 2026-04-17 · Breaking change · API 2026-04 — `inventoryActivate` now preserves `available` quantity
As of API version 2026-04, using the inventoryActivate mutation without specifying an available or onHand argument will no longer default these values to zero. If an item was previously active at a location, any existing - 2026-04-15 · Action required — `ActionBar` removed on mobile: `TitleBar` primary action now renders as an icon button
Mobile primary action now renders as an icon in the title bar On mobile, the primary and secondary actions defined on your TitleBar are changing how they render: The primary action now displays as an icon-only button in - 2026-04-13 · Action required — New CSS variable for mobile safe area insets
New CSS Variable for Mobile Safe Area Insets A new CSS custom property, --shopify-safe-area-inset-bottom , is now available for embedded apps running on Shopify Mobile. This property provides the exact pixel value of hos - 2026-04-13 · Action required · API 2026-07 — DraftOrderLineItem.grams field removed in 2026-07
What's changing We are removing the grams field from the DraftOrderLineItem object in the Admin GraphQL API, starting with version 2026-07. This field was deprecated over 8 years ago. After the 2026-04 API version become - 2026-04-10 · Deprecation · API 2026-07 — New discount fields in the Storefront API's cart types
As of API version 2026-07, several changes have been introduced to the discount fields and amounts in the Storefront API . What's changed Deprecated Fields : The cart.discountAllocations field is deprecated. Use cart.lin - 2026-04-09 · Deprecation · API 2026-04 — Shopify Scripts will be deprecated on June 30, 2026
We are enhancing Shopify Functions with new capabilities for discounts, shipping, and payments. These improvements aim to replace the functionalities you previously achieved using Shopify Scripts, allowing you to build c - 2026-04-07 · Action required — Replacing or deleting a Shopify-hosted file no longer purges its CDN URL
As of April 7, 2026, when you replace or delete a file in the Shopify admin, Shopify will no longer proactively purge the file's URL on cdn.shopify.com/.... The previously cached content will continue to be served until - 2026-04-01 · Breaking change · API 2026-07 — Payment method identifier now required for customerPaymentMethodRemoteCreate
As of API version 2026-07, the payment method identifier field is now required when using the customerPaymentMethodRemoteCreate mutation with Stripe, Authorize.net, or Braintree inputs. The affected fields are: paymentMe - 2026-03-30 · Action required · API 2026-07 — Removing `visible_to_storefront_api` field on metaobject field definitions
What's changing The visibleToStorefrontApi field/input field is deprecated and removed from the unstable version of the GraphQL Admin API for the following types: MetaobjectFieldDefinition MetaobjectFieldDefinitionCreate - 2026-03-25 · Action required — The Shopify CLI app release `--force` flag is deprecated and will be removed
We are deprecating the --force flag on the shopify app deploy and shopify app release commands. The flag will be removed in a Shopify CLI release in May 2026. Why we're making this change The --force flag skips all confi - 2026-03-23 · Breaking change — Removal of pre_tax_price from the Order REST Admin API
The pre_tax_price and pre_tax_price_set fields on order line items in the REST Admin API are being removed. These fields were previously available to stores with the Avalara AvaTax 1.0 integration enabled, which was depr - 2026-03-20 · Action required — Expiring offline access tokens required for new public apps as of April 1, 2026
We're updating how public apps handle offline access tokens to enhance merchant data protection. Starting April 1, 2026, all new public apps must request and use expiring offline access tokens . What apps are affected Pu - 2026-03-20 · Action required — Process refunds only through the original payment processor – Requirement update
We've updated requirement 1.1.15 for Shopify App Store apps. Apps must now process refunds only through the original payment processor. Previously, apps were prohibited from offering methods for processing refunds outsid - 2026-03-16 · Action required · API 2026-04 — New payment decline codes added to `OrderTransactionErrorCode` enum
We're adding new error codes to the OrderTransactionErrorCode enum to provide more granular detail about the transaction failure. You can use this more detailed response to improve customer interactions. What's new These - 2026-03-14 · Action required · API 2026-04 — ShopifyQL returns fields deprecated and replaced with sales reversals fields
In GraphQL Admin API version 2026-04 , several Returns fields in analytics, which can be queried through ShopifyQL , have been deprecated and replaced with renamed versions (e.g., sales_reversals , reversed_quantity ) to - 2026-03-12 · Deprecation — Shopify Scripts deprecation: editing ends April 15, execution ends June 30, 2026
We're continuing to improve Shopify Functions with new capabilities for discounts, shipping, and payments — areas where you've previously relied on Shopify Scripts — to ensure you can build custom logic that fits your un - 2026-03-12 · Action required — Clearer standards for app listing images
We've updated requirement 4.4.4 and added a new requirement 4.4.5 for Shopify App Store apps. Requirement 4.4.4 now provides clearer standards for image quality: images should primarily show your app's actual user interf - 2026-03-09 · Action required · API 2026-07 — `inventorySetScheduledChanges` mutation is being removed with no replacement
The inventorySetScheduledChanges mutation will be removed from the GraphQL Admin API in version 2026-07 . This mutation has no replacement, so any apps currently using it should stop relying on it to avoid disruptions. T - 2026-03-06 · Action required · API 2026-04 — Removed Checkout ID from checkout and order webhooks
To simplify and standardize our checkout references, Shopify has removed the following fields from checkout and orders webhooks. Merchants and partners should update their webhook handlers to use the token or checkout_to - 2026-03-02 · Action required — Bare query strings no longer bust the cache for assets
Action required We're enhancing Shopify's asset caching to improve load times. As part of this update, we are modifying the URL query parameters recognized for cache busting. Effective March 24, 2026, bare query strings - 2026-02-26 · Deprecation — Legacy customer accounts are deprecated
Legacy customer accounts are no longer available to new stores and existing stores not using it. Shopify will stop providing feature updates and technical support for this older version. A final sunset date for legacy cu - 2026-02-26 · Deprecation — Legacy customer accounts are now deprecated
Legacy customer accounts are no longer available to new stores and existing stores not using it. Shopify will stop providing feature updates and technical support for this older version. A final sunset date for legacy cu - 2026-02-24 · Action required — New APIs to read and write shipping options in delivery profile
As part of the enhanced UI for creating shipping options, a shipping option can now include multiple tiered rates grouped together. If your app integrates with delivery profiles and uses DeliveryMethodDefinition and Deli - 2026-02-19 · Action required · API 2026-04 — JSON metafield values limited to 128KB
When using API version 2026-04 or later, JSON type metafield writes will be limited to 128KB. Limits for all other metafield types remain unchanged ( current limits ). All apps that use JSON fields (prior to April 1st, 2