We check Shopify's developer changelog every day, because we run production integrations on the Shopify API. This page lists the 165 changes we have recorded since monitoring started on 29 March 2026, newest first.
Our last successful check was on 27 September 2026. We are on it; until then this page may miss the newest changes.
9 breaking changes and 2 deprecations in the Shopify API in the last 90 days. The latest: “automaticDiscounts query is removed in API version 2027-01” (18 September 2026).
Labels are assigned automatically. Check the vendor's note before planning work around an entry.
The automaticDiscounts query will be removed in the 2027-01 API version, requiring integrations to migrate to alternative endpoints.
Affects one of your integrations? We take over the migration, at a fixed priceThe staffMemberId field has been removed from POS UI Extensions in version 2026-10, breaking existing code that relies on this property.
Affects one of your integrations? We take over the migration, at a fixed priceEvents payloads and subscription configuration have been updated, requiring integration updates to continue receiving webhooks correctly.
Affects one of your integrations? We take over the migration, at a fixed priceThe Discounts Allocator Function API developer preview period has ended, requiring any experimental implementations to transition to production or alternative solutions.
The Customer Address APIs now support countryCode parameter and the previous approach is being deprecated.
Product variants now support multiple barcodes through a new barcodes field, replacing the previous single barcode field, requiring integration updates.
Improvements made to handle expiring offline access tokens more reliably in the Admin GraphQL API.
New event topics have been added to the Events & webhooks system, expanding notification capabilities.
Script tags are deprecated and will cease to function on March 1, 2027, requiring migration to alternative solutions.
Inventory status for draft orders and transfers/shipments will change from reserved to committed in API version 2026-10, affecting inventory calculations.
The orderCreate mutation now supports multiple tracking numbers for each fulfillment, adding new functionality to order creation.
Oxygen deployment option now available for Hydrogen development stores.
As of API version 2026-10, updating an order's shipping address now recalculates taxes automatically, changing the financial data returned by the mutation.
New API for subscription contract calculations released in early access for testing.
The GraphQL Admin API now returns errors for invalid metafield queries instead of silently failing, which may break existing error handling.
New Liquid block and partial tags enable more modular and composable template structures.
New event topics for metafield changes and additional webhook triggers have been added.
Physical inventory management capabilities are now available in feature preview in the Admin GraphQL API.
Card deposit API endpoint now requires mutual TLS certificate authentication for enhanced security.
New channelId argument added to @inContext directive in Storefront API 2026-10.
POS adds pos.app.ready.data for persistent headless event handling; .observe targets are no longer supported and must be migrated.
POS UI extensions 2026-07 changes to use per-unit fixed-amount line item discounts instead of total amount discounts.
The Customer.lastIncompleteCheckout and Checkout types are being removed from the Customer Account API in version 2026-10.
New MarketRegionSubdivision type added to Markets API for finer geographic targeting.
OrderDisplayFulfillmentStatus enum updated to return FULFILLMENT_NOT_REQUIRED for orders with no fulfillable items.
In API v2026-07, BusinessEntity includes new legalEntityId field for stable legal entity identification across shops and markets.
Cumulative marketing engagements feature deprecated with future removal date requiring action from users.
New GraphQL Customer Account API fields expose draft order discounts and per-line-item allocations for precise discount querying.
discountedUnitPrice field on DraftOrderLineItem deprecated in Customer Account API.
New market-driven shipping capabilities released in feature preview requiring action from integrators.
Merchant-owned delivery profile APIs deprecated in favor of market-driven shipping APIs.
GiftCard object now includes lineItem field linking gift cards to their originating order or null if issued manually.
Sales channel apps can now define granular order attribution via new 2026-07 APIs, passing handles via orders/carts and managing via Admin GraphQL.
PaymentMandateResource object in API 2026-07 now includes a new id field for improved mandate identification.
Carrier services are no longer automatically added to default shipping profiles in the Admin GraphQL API, requiring manual configuration by integrations.
Storefront MCP cart tools are deprecated in favor of UCP Cart MCP, requiring migration to the new tool set.
The priceRule field is being removed from DraftOrderDiscountNotAppliedWarning in API version 2026-10.
The ITEM_NOT_STOCKED_AT_LOCATION error type is being removed from the Admin GraphQL API, requiring integration updates to handle the new error response.
Flow action URLs now support relative paths, enabling easier use of tunnels during local development.
New capability to create app-owned delivery profiles covering all shippable items.
Intents API now supports pick:shopify/File intent to let merchants choose files from their Shopify file library.
Apps must use Customer Account API to authenticate buyers by December 1, 2026, to maintain Built for Shopify status.
Performance improvement for bulk queries in Admin GraphQL API.
New shippingLabelPurchase mutation lets apps buy Shopify Shipping labels asynchronously for fulfillment orders.
API 2026-07 adds channel markets support; create, update, and query markets per sales channel for channel-specific availability, pricing, and currencies.
Admin GraphQL API 2026-07 allows defining and setting metafields directly in inventory transfers without separate calls.
A new Collection model and associated APIs are now available in the Admin GraphQL API, providing enhanced collection management capabilities.
App discount UI extensions can now configure purchaseType and recurringCycleLimit through the discounts plugin.
appliesOnSubscription and appliesOnOneTimePurchase fields on app discounts are now enforced at checkout.
All app developers can now build Sidekick app extensions to integrate with Sidekick and access data or take action within their apps.
New WhatsApp marketing consent fields added to Admin and Customer Account APIs.
Metafields stored on the app resource must have a metafield definition with customer accounts permissions to be accessible through Customer Account API.
New Partner API 2026-07 mutation lets partners cancel owned public app subscriptions and request prorated credits.
Shop User metafields are now readable during checkout via Shopify Functions for accessing buyer-specific data.
CartLine type now returns viewKey to correlate returned lines with view_key sent to cartLinesUpdate and cartLinesRemove.
AI Toolkit and enhanced docs available to speed up checkout/customer account UI extension upgrades to Polaris web components; deadline October 1, 2026.
New Metaobject values property enables simplified reads and writes with automatic conversion to/from JSON objects.
Headless checkout docs now use sso=silent for silent SSO replacing logged_in=true; existing URLs remain valid with terminology changes only.
GraphQL Admin API v2026-07 adds GiftCardCashOutTransaction to distinguish cash-out adjustments from debits using __typename.
Inventory transfer webhooks now include origin and destination fields; documentation for inventoryTransferSetItems and inventoryTransferRemoveItems clarified with more descriptive errors.
API v2026-07 adds local currency gift cards via GraphQL Admin API with issuanceCurrency configuration and cross-currency redemption support.
Storefront API 2026-07 cartLinesUpdate and cartLinesRemove now accept view_key to identify cart lines.
App Home UI extensions let custom-distribution apps build a Shopify-hosted App Home page with Preact and Polaris web components.
Customize content for agent/LLM files by adding specific templates in Themes.
Create App Home landing pages using Preact-based admin UI extensions with admin.app.home.render; available for custom apps from API 2026-07.
New Next Generation Events system released in developer preview with field-level triggers and custom GraphQL payloads.
SemVer, auto-updates, removing deprecated flags and commands: Shopify CLI 4.0 introduces semantic versioning, automatic updates, and removes the --force flag along with deprecated commands.
All public apps are required to use expiring offline access tokens by January 1, 2027, breaking existing auth implementations using non-expiring tokens.
MetaobjectAdminAccess enums PRIVATE and PUBLIC_READ are deprecated and will be removed in API version 2026-07.
Optional consent with new hooks, intents for contextual launches, async storage limits, availableForSale for stock checks, and deprecation of localStorage/sessionStorage.
Next Generation Events provide field-level trigger control, custom GraphQL payloads, and filters as an improvement over traditional webhooks.
FulfillmentOrderLineItem now supports querying shippingLine to identify shipping methods for merged fulfillment orders.
The GraphQL Admin API's Order object now includes the checkoutToken field to access the checkout token used for order creation.
New API for unified branding across checkout, customer accounts, and sign-in.
Function run logs are now viewable in Dev Dashboard based on app's access scopes.
See app usage and performance data in your Dev Dashboard: Send custom and billable app events to the App Events API to see holistic app performance metrics in Dev Dashboard Logs.
The GraphQL Admin API now includes the cartToken field in the Order object for accessing the cart token used to create an order.
Starting with Storefront API version 2026-07, Cart emits warnings for products unavailable in the buyer's location.
charge for usage, recurring subscriptions, or both: Shopify App Pricing lets configure usage-based, fixed, or combined pricing directly in app submission with Shopify handling metering and invoicing.
Create discounts eligible for specific markets, giving better control over which buyers can access discounts based on region.
Shopify now applies stricter rate limits to bots and agents accessing the Storefront API; higher limits available with Web Bot Auth.
ProductVariant is now Publishable, allowing fine-grained control over visibility per channel with variants defaulting published.
App automation tokens enable CI/CD deployment for all apps via Dev Dashboard, replacing CLI tokens; existing CLI tokens remain valid until expiry.
New feature: Seven new Settings intents added for notifications, payments, gift cards, delivery, and business details.
A new feature preview for fulfilling orders with both ship and pickup methods is now available.
New feature: New actor field in subscription mutations tracks action initiators (customer, merchant, partner) in API v2026-07.
The default value for the appliesOnSubscription field in app discount inputs has changed from false to true, potentially affecting discount behavior.
GraphQL Admin API v2026-04 now supports multiple product discounts per cart line to aid Scripts migration before June 30 sunset.
New feature: GraphQL Admin API now supports creating, updating, reading, and deleting merchant metric targets.
Checkout metafields deprecated in checkout and customer account UI extensions with migration required.
The Admin GraphQL API's LineItem now has priceAfterAllDiscountsBeforeTaxesSet field showing line item prices post-discount, pre-tax.
POS 11.5 changes fixed-amount discounts to per-unit calculation affecting setLineItemDiscount; future API versions will require per-unit amounts.
Shopify now supports QR codes for discount codes usable in POS and online; apps can generate these without changes.
Apps can now read customer tax ID (VAT number) via GraphQL Admin API v2026-07 using Customer.taxSettings.taxId.
Breaking change fixing totalUnsettledSet calculation for pending captures in Admin GraphQL API.
Change requiring action: Shopify is introducing CSS content subsetting for stylesheet tags to improve storefront performance.
Breaking change where Storefront Catalog MCP now implements UCP protocol.
AI-powered self-review, automated pre-submission checks, and end-to-end review management now available in Partner Dashboard.
Breaking change where inventoryActivate mutation now preserves available quantity on reactivation.
Shopify will renew mTLS client certificate for Payments Apps starting Jun 15, 2026; no action needed unless using custom certificate checks.
TitleBar primary action now renders as an icon button: Breaking change in App Bridge where ActionBar removed on mobile with primary action rendering as icon button.
The MOST_RELEVANT value is now available for GraphQL Admin API's CollectionSortOrder in API version 2026-07.
New feature: New testing library enables unit tests for UI extensions across Checkout, Admin, Customer Accounts, and POS.
The grams field is being removed from DraftOrderLineItem in API version 2026-07.
New CSS variable added to App Bridge for mobile safe area insets.
New discount fields deprecated in Storefront API cart types.
Hydrogen April 2026 updates to Storefront API 2026-04, makes Storefront API proxy mandatory, and enables backend consent mode.
Connect your AI tools to the Shopify platform: New Shopify AI Toolkit connects AI tools to Shopify's docs, API schemas, code validation, and store management; install once via plugin.
Deprecation notice: Shopify Scripts will be fully deprecated on June 30, 2026.
Replacing or deleting files no longer purges cdn.shopify.com URLs; reference files via Shopify's URL helpers for current versioned URLs.
Shopify POS now supports custom cash management with new GraphQL APIs and UI extensions including shared cash drawers and bulk export.
Discount functions now support prerequisites for BXGY discounts allowing developers to specify Buy X conditions in API version 2026-04.
New tags field added to discounts in API version 2026-04 for efficient labeling and organization.
New access field added to StandardMetaobjectDefinitionTemplate in API version 2026-07 for visibility of access rules.
App-owned metaobjects now require no access scopes; ensure Admin API version 2026-04+ for this feature.
The delegateAccessTokenCreate GraphQL mutation now returns expiresIn field on DelegateAccessToken type.
New components field added to DraftOrderLineItem in API version 2026-04; new optional flattenComponents argument defaults to false.
GraphQL Admin API v2026-07 requires payment method ID for Stripe, Authorize.net, and Braintree in customerPaymentMethodRemoteCreate.
Polaris reference docs now align with GraphQL versioning; only last four stable versions will have published docs starting 2026-04.
New RBAC and organization structure for partner organizations with auto-migration starting March 30; no action required.
The --force flag in Shopify CLI will be removed in May 2026; update CI/CD scripts to use --allow-updates instead.
Version 2026-04 adds barcode support to inventory shipments for faster receiving with support for unique barcodes up to 255 characters.
The pre_tax_price fields are removed from REST Admin API; use GraphQL Admin API for order line item pricing instead.
Customer data erasure requests will process 10 days after submission regardless of last order date.
Admin intents now support direct access to Shopify Settings pages via API calls.
Starting April 1, 2026, new public apps must use expiring offline access tokens instead of non-expiring tokens for improved security.
Shopify apps must process refunds via the original payment processor using refundCreate or returnProcess.
API v2026-04 introduces includeInactive argument for inventoryLevels queries to retrieve inactive inventory while maintaining backward compatibility.
API version 2026-04 adds isActive field to InventoryLevel, allowing queries for inactive levels without clearing quantities.
The inventoryTransferDelete mutation returns INVALID_STATE error in 2026-07 if product import is in progress.
POS UI extensions now run offline when enabled; requires POS v11.0+ and Shopify CLI v3.92+.
The createdAt and updatedAt fields become available in API version 2026-04.
The fieldDefinitions input argument of metaobjectDefinitionCreate mutation becomes optional in 2026-04.
Payments Apps API now offers detailed decline codes and source field for rejected payments; RISKY code deprecated in favor of FRAUD_SUSPECTED.
Returns fields in analytics are deprecated in API v2026-04 and replaced with renamed versions (e.g., sales reversals) to better reflect order adjustments.
New development shops have access to checkout and customer account UI extensions by default.
The inventorySetScheduledChanges mutation is being removed in API version 2026-07; use inventoryAdjustQuantities as an alternative.
As of API version 2026-04, the id field from checkouts webhooks and checkout_id field from orders webhooks are removed; use checkout token instead.
Shop Minis updates include product tagging for UGC, SafeArea support, CLI commands, improved consent flow, and scope simplification.
The analyticsQueryable feature enables metafields for Shopify Analytics on Products, Product Variants, Orders, and Customers.
Asset caching update ends support for bare query strings for cache busting; use Liquid filters like asset_url instead.
In GraphQL API v2026-04, Shopify Functions can access discount details at cart, line item, and delivery levels.
Accelerated checkouts now support purchasing products with add-ons directly from the product page.
Legacy customer accounts are no longer available to new stores; merchants should upgrade to latest version.
New APIs support multiple tiered rates for shipping options; migrate to new fields to avoid future issues.
You can now pass locale and region_country parameters to Customer Account API authorization endpoint for market-aware login URLs.
Introduce SubscriptionBillingAttemptState: GraphQL Admin API now includes SubscriptionBillingAttemptState, replacing several fields with discriminated union.
Payments Apps API now supports new rejection codes and optional merchant message for verification rejections.
Shopify CLI 3.90.1 adds commands for executing queries, mutations, and bulk operations, enhancing automation capabilities.
Starting with API version 2026-04, JSON metafield values will be capped at 128KB, potentially affecting integrations that store large JSON objects.
New remainingLineItemsWeight field added to the FulfillmentOrder GraphQL type.
Added 3 enum values to ColumnDataType: RATING (float), STRING IDENTITY (GID/UUID), COLOR (HEX).
Webhook subscriptions can now have optional names for easier management; names appear in request headers up to 50 characters.
The shopify.app.extensions() method in App Bridge now supports Point of Sale UI extensions.
Shop Minis January 2026 updates include delayed consent popup, curated Explore screen, CLI dashboard command, and privacy controls.
Query gift card expiration settings via GraphQL Admin API with new expirationConfiguration field.
Order metafield definitions now support cartToOrderCopyable flag; when enabled, cart metafield values copy to matching order metafields.
new payment error code and error classification: New payment error codes in Admin GraphQL API enhance diagnosis of subscription billing issues.
You can now define up to 30 app blocks in your theme app extension, up from 25.
New tracks_inventory filter added for querying products by inventory tracking status.
POS version 10.19.0 now displays error page for unhandled callback errors; developers must test callbacks.
Access to events data over a year old is removed from Admin GraphQL and REST APIs, affecting long-term data retention.
Theme developers can now use article_list setting type to let merchants select multiple blog articles for sections and blocks.
Shopify CLI 3.89 adds --allow-updates and --allow-deletes flags for safer app deployment control in CI/CD pipelines.
In API version 2026-04, permitsSkuSharing is removed from FulfillmentService with SKU sharing enabled by default.
We watch Shopify because we run integrations on it. If one of yours depends on Shopify, we can take it over: build it properly, operate it, and fix it when Shopify changes, before your data is affected. Fixed-price scoping quote within 48 hours.