# Shopify API changelog 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. **In short:** 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). - [Official Shopify changelog](https://shopify.dev/changelog?filter=api) - [RSS feed: Shopify API changes](https://seamless.engineering/api-changelog/shopify/rss.xml) - [All Shopify integrations](https://seamless.engineering/integrations/shopify/) ## Shopify API changes Labels are assigned automatically. Check the vendor's note before planning work around an entry. ### September 2026 - **automaticDiscounts query is removed in API version 2027-01** (Breaking, 18 Sept 2026): The automaticDiscounts query will be removed in the 2027-01 API version, requiring integrations to migrate to alternative endpoints. - **Removed session.currentSession.staffMemberId from POS UI Extensions (2026-10)** (Breaking, 17 Sept 2026): The staffMemberId field has been removed from POS UI Extensions in version 2026-10, breaking existing code that relies on this property. - **Updates to Events payloads and subscription configuration** (Breaking, 16 Sept 2026): Events payloads and subscription configuration have been updated, requiring integration updates to continue receiving webhooks correctly. - **Discounts Allocator Function API developer preview has ended** (Breaking, 10 Sept 2026): The Discounts Allocator Function API developer preview period has ended, requiring any experimental implementations to transition to production or alternative solutions. - **Customer Address APIs now support countryCode** (Deprecation, 8 Sept 2026): The Customer Address APIs now support countryCode parameter and the previous approach is being deprecated. - **Variants now support multiple barcodes** (Breaking, 8 Sept 2026): Product variants now support multiple barcodes through a new barcodes field, replacing the previous single barcode field, requiring integration updates. ### August 2026 - **More resilient refreshes for expiring offline access tokens** (Bug fix, 28 Aug 2026): Improvements made to handle expiring offline access tokens more reliably in the Admin GraphQL API. - **Four additional topics now available for Events** (New feature, 26 Aug 2026): New event topics have been added to the Events & webhooks system, expanding notification capabilities. - **Script tags deprecated and will stop running on March 1, 2027** (Deprecation, 24 Aug 2026): Script tags are deprecated and will cease to function on March 1, 2027, requiring migration to alternative solutions. - **Draft order and transfer/shipment inventory moving from reserved to committed** (Breaking, 5 Aug 2026): Inventory status for draft orders and transfers/shipments will change from reserved to committed in API version 2026-10, affecting inventory calculations. - **orderCreate mutation now supports multiple tracking numbers per fulfillment** (New feature, 3 Aug 2026): The orderCreate mutation now supports multiple tracking numbers for each fulfillment, adding new functionality to order creation. - **Oxygen is now available on development stores** (New feature, 3 Aug 2026): Oxygen deployment option now available for Hydrogen development stores. ### July 2026 - **Updating an order's shipping address recalculates taxes as of API version 2026-10** (Breaking, 30 Jul 2026): As of API version 2026-10, updating an order's shipping address now recalculates taxes automatically, changing the financial data returned by the mutation. - **SubscriptionContractCalculation API now available in early access** (New feature, 27 Jul 2026): New API for subscription contract calculations released in early access for testing. - **Invalid metafield queries now return errors in the GraphQL Admin API** (Breaking, 24 Jul 2026): The GraphQL Admin API now returns errors for invalid metafield queries instead of silently failing, which may break existing error handling. - **Liquid templates can now compose pages with blocks and partials** (New feature, 21 Jul 2026): New Liquid block and partial tags enable more modular and composable template structures. - **Metafield triggers and additional topics now available for Events** (New feature, 21 Jul 2026): New event topics for metafield changes and additional webhook triggers have been added. - **Physical inventory feature preview** (New feature, 17 Jul 2026): Physical inventory management capabilities are now available in feature preview in the Admin GraphQL API. - **Card deposit endpoint now requires mTLS certificate** (Breaking, 16 Jul 2026): Card deposit API endpoint now requires mutual TLS certificate authentication for enhanced security. - **Storefront API @inContext supports channelId** (New feature, 15 Jul 2026): New channelId argument added to @inContext directive in Storefront API 2026-10. - **POS Extensions background extension target support** (Breaking, 9 Jul 2026): 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 uses per-unit fixed-amount line item discounts** (Breaking, 8 Jul 2026): POS UI extensions 2026-07 changes to use per-unit fixed-amount line item discounts instead of total amount discounts. - **Customer Account API Customer.lastIncompleteCheckout and Checkout types removed in 2026-10** (Breaking, 6 Jul 2026): The Customer.lastIncompleteCheckout and Checkout types are being removed from the Customer Account API in version 2026-10. - **Markets APIs now support MarketRegionSubdivision** (New feature, 3 Jul 2026): New MarketRegionSubdivision type added to Markets API for finer geographic targeting. - **OrderDisplayFulfillmentStatus now returns FULFILLMENT_NOT_REQUIRED** (New feature, 3 Jul 2026): OrderDisplayFulfillmentStatus enum updated to return FULFILLMENT_NOT_REQUIRED for orders with no fulfillable items. - **BusinessEntity now exposes legalEntityId in GraphQL Admin API** (New feature, 1 Jul 2026): In API v2026-07, BusinessEntity includes new legalEntityId field for stable legal entity identification across shops and markets. - **Deprecation of cumulative marketing engagements** (Deprecation, 1 Jul 2026): Cumulative marketing engagements feature deprecated with future removal date requiring action from users. - **Discount application information now available for draft orders on Customer Account API** (New feature, 1 Jul 2026): New GraphQL Customer Account API fields expose draft order discounts and per-line-item allocations for precise discount querying. - **discountedUnitPrice on DraftOrderLineItem Customer Account API deprecation** (Deprecation, 1 Jul 2026): discountedUnitPrice field on DraftOrderLineItem deprecated in Customer Account API. - **Market-driven shipping now available in feature preview** (New feature, 1 Jul 2026): New market-driven shipping capabilities released in feature preview requiring action from integrators. - **Merchant-owned delivery profile APIs deprecated for market-driven shipping** (Deprecation, 1 Jul 2026): Merchant-owned delivery profile APIs deprecated in favor of market-driven shipping APIs. - **New lineItem field on the GiftCard object** (New feature, 1 Jul 2026): GiftCard object now includes lineItem field linking gift cards to their originating order or null if issued manually. ### June 2026 - **Configure order attribution for sales channel apps** (New feature, 30 Jun 2026): Sales channel apps can now define granular order attribution via new 2026-07 APIs, passing handles via orders/carts and managing via Admin GraphQL. - **Payment mandates now expose an id field** (New feature, 27 Jun 2026): PaymentMandateResource object in API 2026-07 now includes a new id field for improved mandate identification. - **Carrier services will no longer be automatically added to the default shipping profile** (Breaking, 26 Jun 2026): 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 being deprecated in favour of UCP Cart MCP** (Deprecation, 24 Jun 2026): Storefront MCP cart tools are deprecated in favor of UCP Cart MCP, requiring migration to the new tool set. - **DraftOrderDiscountNotAppliedWarning.priceRule removed in GraphQL Admin API 2026-10** (Breaking, 23 Jun 2026): The priceRule field is being removed from DraftOrderDiscountNotAppliedWarning in API version 2026-10. - **Removal of ITEM_NOT_STOCKED_AT_LOCATION error** (Breaking, 19 Jun 2026): 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 extensions now support relative paths** (New feature, 18 Jun 2026): Flow action URLs now support relative paths, enabling easier use of tunnels during local development. - **Admin GraphQL API now supports app-owned delivery profiles that cover all shippable items** (New feature, 17 Jun 2026): New capability to create app-owned delivery profiles covering all shippable items. - **Apps can now open Shopify's file picker with the Intents API** (New feature, 17 Jun 2026): Intents API now supports pick:shopify/File intent to let merchants choose files from their Shopify file library. - **Built for Shopify requirements for Returns/Exchanges and Subscription apps** (Deprecation, 17 Jun 2026): Apps must use Customer Account API to authenticate buyers by December 1, 2026, to maintain Built for Shopify status. - **Bulk queries now execute up to 4X faster** (Bug fix, 17 Jun 2026): Performance improvement for bulk queries in Admin GraphQL API. - **Buy Shipping Labels with GraphQL Admin API** (New feature, 17 Jun 2026): New shippingLabelPurchase mutation lets apps buy Shopify Shipping labels asynchronously for fulfillment orders. - **Create channel markets with GraphQL Admin API** (New feature, 17 Jun 2026): API 2026-07 adds channel markets support; create, update, and query markets per sales channel for channel-specific availability, pricing, and currencies. - **Define and set metafields on inventory transfers** (New feature, 17 Jun 2026): Admin GraphQL API 2026-07 allows defining and setting metafields directly in inventory transfers without separate calls. - **New Collection model and APIs now available** (Breaking, 17 Jun 2026): A new Collection model and associated APIs are now available in the Admin GraphQL API, providing enhanced collection management capabilities. - **New purchaseType and recurringCycleLimit fields in discount UI extensions** (New feature, 17 Jun 2026): App discount UI extensions can now configure purchaseType and recurringCycleLimit through the discounts plugin. - **Purchase-type filtering now enforced for app discounts** (Breaking, 17 Jun 2026): appliesOnSubscription and appliesOnOneTimePurchase fields on app discounts are now enforced at checkout. - **Sidekick app extensions available** (New feature, 17 Jun 2026): All app developers can now build Sidekick app extensions to integrate with Sidekick and access data or take action within their apps. - **WhatsApp marketing consent now available in Admin API and Customer Account API** (New feature, 17 Jun 2026): New WhatsApp marketing consent fields added to Admin and Customer Account APIs. - **Metafields now require a definition for Customer Account API access** (Breaking, 16 Jun 2026): Metafields stored on the app resource must have a metafield definition with customer accounts permissions to be accessible through Customer Account API. - **New appSubscriptionCancel mutation in Partner API** (New feature, 16 Jun 2026): New Partner API 2026-07 mutation lets partners cancel owned public app subscriptions and request prorated credits. - **Shop User Metafields in Shopify Functions** (New feature, 13 Jun 2026): Shop User metafields are now readable during checkout via Shopify Functions for accessing buyer-specific data. - **Read a cart line's viewKey from the CartLine type** (New feature, 12 Jun 2026): CartLine type now returns viewKey to correlate returned lines with view_key sent to cartLinesUpdate and cartLinesRemove. - **Shopify AI Toolkit for upgrading extensions to Polaris web components** (New feature, 11 Jun 2026): AI Toolkit and enhanced docs available to speed up checkout/customer account UI extension upgrades to Polaris web components; deadline October 1, 2026. - **Streamlined Metaobject API** (New feature, 11 Jun 2026): New Metaobject values property enables simplified reads and writes with automatic conversion to/from JSON objects. - **Headless checkout SSO is now documented with sso=silent** (Other, 8 Jun 2026): Headless checkout docs now use sso=silent for silent SSO replacing logged_in=true; existing URLs remain valid with terminology changes only. - **GiftCardCashOutTransaction is now resolvable from GiftCardTransaction** (New feature, 5 Jun 2026): GraphQL Admin API v2026-07 adds GiftCardCashOutTransaction to distinguish cash-out adjustments from debits using __typename. - **Inventory transfer webhooks include origin and destination location IDs** (New feature, 5 Jun 2026): Inventory transfer webhooks now include origin and destination fields; documentation for inventoryTransferSetItems and inventoryTransferRemoveItems clarified with more descriptive errors. - **Local currency support gift cards now available in GraphQL Admin API** (New feature, 5 Jun 2026): API v2026-07 adds local currency gift cards via GraphQL Admin API with issuanceCurrency configuration and cross-currency redemption support. - **Identify cart lines by view_key in cartLinesUpdate and cartLinesRemove** (New feature, 2 Jun 2026): Storefront API 2026-07 cartLinesUpdate and cartLinesRemove now accept view_key to identify cart lines. - **App Home as UI extension** (New feature, 1 Jun 2026): App Home UI extensions let custom-distribution apps build a Shopify-hosted App Home page with Preact and Polaris web components. ### May 2026 - **Customize /llms.txt, /llms-full.txt and /agents.md** (New feature, 28 May 2026): Customize content for agent/LLM files by adding specific templates in Themes. - **Build App Home as a UI extension** (New feature, 27 May 2026): Create App Home landing pages using Preact-based admin UI extensions with admin.app.home.render; available for custom apps from API 2026-07. - **Next Generation Events now available in developer preview** (New feature, 27 May 2026): New Next Generation Events system released in developer preview with field-level triggers and custom GraphQL payloads. - **Shopify CLI 4.0** (Breaking, 21 May 2026): 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. - **Expiring offline access tokens required for all public apps as of January 1, 2027** (Breaking, 20 May 2026): All public apps are required to use expiring offline access tokens by January 1, 2027, breaking existing auth implementations using non-expiring tokens. - **Removing deprecated PRIVATE and PUBLIC_READ enums on metaobject definitions** (Breaking, 20 May 2026): MetaobjectAdminAccess enums PRIVATE and PUBLIC_READ are deprecated and will be removed in API version 2026-07. - **Shop Minis March April 2026 update** (Deprecation, 20 May 2026): Optional consent with new hooks, intents for contextual launches, async storage limits, availableForSale for stock checks, and deprecation of localStorage/sessionStorage. - **Next Generation Events now available in developer preview** (New feature, 19 May 2026): Next Generation Events provide field-level trigger control, custom GraphQL payloads, and filters as an improvement over traditional webhooks. - **Shipping line field now available on FulfillmentOrderLineItem** (New feature, 18 May 2026): FulfillmentOrderLineItem now supports querying shippingLine to identify shipping methods for merged fulfillment orders. - **New checkoutToken field on Order object** (New feature, 15 May 2026): The GraphQL Admin API's Order object now includes the checkoutToken field to access the checkout token used for order creation. - **Checkout And Accounts Configuration API for unified branding** (New feature, 13 May 2026): New API for unified branding across checkout, customer accounts, and sign-in. - **Function run log details are now automatically visible with the right access scopes** (New feature, 13 May 2026): Function run logs are now viewable in Dev Dashboard based on app's access scopes. - **App Events** (New feature, 12 May 2026): 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. - **New cartToken field added to the Order object** (New feature, 12 May 2026): The GraphQL Admin API now includes the cartToken field in the Order object for accessing the cart token used to create an order. - **New PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION warning code in Storefront API Cart** (New feature, 12 May 2026): Starting with Storefront API version 2026-07, Cart emits warnings for products unavailable in the buyer's location. - **Shopify App Pricing** (New feature, 12 May 2026): 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. - **Target discounts to specific markets** (New feature, 8 May 2026): Create discounts eligible for specific markets, giving better control over which buyers can access discounts based on region. - **Bots and agents should identify themselves via Web Bot Auth** (Other, 7 May 2026): Shopify now applies stricter rate limits to bots and agents accessing the Storefront API; higher limits available with Web Bot Auth. - **Publish and unpublish product variants independently from product** (New feature, 7 May 2026): ProductVariant is now Publishable, allowing fine-grained control over visibility per channel with variants defaulting published. - **App deployment in CI/CD is now available for all apps** (New feature, 6 May 2026): App automation tokens enable CI/CD deployment for all apps via Dev Dashboard, replacing CLI tokens; existing CLI tokens remain valid until expiry. - **More admin intents now support Settings** (New feature, 6 May 2026): New feature: Seven new Settings intents added for notifications, payments, gift cards, delivery, and business details. - **Ship and pickup in one order now available in feature preview** (New feature, 6 May 2026): A new feature preview for fulfilling orders with both ship and pickup methods is now available. - **Add actor field to subscription contract and billing attempt mutations** (New feature, 4 May 2026): New feature: New actor field in subscription mutations tracks action initiators (customer, merchant, partner) in API v2026-07. - **Default value of appliesOnSubscription changed to true for app discount inputs** (Other, 4 May 2026): The default value for the appliesOnSubscription field in app discount inputs has changed from false to true, potentially affecting discount behavior. ### April 2026 - **Multiple product discounts can apply on a single cart line** (New feature, 30 Apr 2026): GraphQL Admin API v2026-04 now supports multiple product discounts per cart line to aid Scripts migration before June 30 sunset. - **Analytics metric targets now available in the GraphQL Admin API** (New feature, 29 Apr 2026): New feature: GraphQL Admin API now supports creating, updating, reading, and deleting merchant metric targets. - **Deprecation of checkout metafields in checkout and customer account UI extensions** (Deprecation, 27 Apr 2026): Checkout metafields deprecated in checkout and customer account UI extensions with migration required. - **LineItem.priceAfterAllDiscountsBeforeTaxesSet field now available** (New feature, 27 Apr 2026): The Admin GraphQL API's LineItem now has priceAfterAllDiscountsBeforeTaxesSet field showing line item prices post-discount, pre-tax. - **Minor rounding change for custom line item discounts in POS 11.5** (Other, 27 Apr 2026): POS 11.5 changes fixed-amount discounts to per-unit calculation affecting setLineItemDiscount; future API versions will require per-unit amounts. - **Scannable discount codes** (New feature, 27 Apr 2026): Shopify now supports QR codes for discount codes usable in POS and online; apps can generate these without changes. - **Customer tax settings now available in Admin API** (New feature, 24 Apr 2026): Apps can now read customer tax ID (VAT number) via GraphQL Admin API v2026-07 using Customer.taxSettings.taxId. - **totalUnsettledSet calculation fixed for pending captures** (Breaking, 24 Apr 2026): Breaking change fixing totalUnsettledSet calculation for pending captures in Admin GraphQL API. - **Automatic CSS subsetting for {% stylesheet %} tags** (Other, 23 Apr 2026): Change requiring action: Shopify is introducing CSS content subsetting for stylesheet tags to improve storefront performance. - **Storefront Catalog MCP now implements UCP** (New feature, 22 Apr 2026): Breaking change where Storefront Catalog MCP now implements UCP protocol. - **New app submission experience in Partner Dashboard** (New feature, 20 Apr 2026): AI-powered self-review, automated pre-submission checks, and end-to-end review management now available in Partner Dashboard. - **inventoryActivate now preserves available quantity** (Breaking, 17 Apr 2026): Breaking change where inventoryActivate mutation now preserves available quantity on reactivation. - **mTLS client certificate renewal for Payments Apps** (Other, 16 Apr 2026): Shopify will renew mTLS client certificate for Payments Apps starting Jun 15, 2026; no action needed unless using custom certificate checks. - **ActionBar removed on mobile** (Breaking, 15 Apr 2026): 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. - **Added MOST_RELEVANT value for CollectionSortOrder** (New feature, 15 Apr 2026): The MOST_RELEVANT value is now available for GraphQL Admin API's CollectionSortOrder in API version 2026-07. - **Automated testing for Shopify UI extensions with @shopify/ui-extensions-tester** (New feature, 13 Apr 2026): New feature: New testing library enables unit tests for UI extensions across Checkout, Admin, Customer Accounts, and POS. - **DraftOrderLineItem.grams field removed in 2026-07** (Breaking, 13 Apr 2026): The grams field is being removed from DraftOrderLineItem in API version 2026-07. - **New CSS variable for mobile safe area insets** (New feature, 13 Apr 2026): New CSS variable added to App Bridge for mobile safe area insets. - **New discount fields in the Storefront API's cart types** (Deprecation, 10 Apr 2026): New discount fields deprecated in Storefront API cart types. - **Hydrogen April 2026 release** (Breaking, 9 Apr 2026): Hydrogen April 2026 updates to Storefront API 2026-04, makes Storefront API proxy mandatory, and enables backend consent mode. - **Shopify AI Toolkit** (New feature, 9 Apr 2026): 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. - **Shopify Scripts will be deprecated on June 30, 2026** (Deprecation, 9 Apr 2026): Deprecation notice: Shopify Scripts will be fully deprecated on June 30, 2026. - **Replacing or deleting a Shopify-hosted file no longer purges its CDN URL** (Other, 7 Apr 2026): Replacing or deleting files no longer purges cdn.shopify.com URLs; reference files via Shopify's URL helpers for current versioned URLs. - **New retail cash management capabilities** (New feature, 2 Apr 2026): Shopify POS now supports custom cash management with new GraphQL APIs and UI extensions including shared cash drawers and bulk export. - **Add Prerequisites to Product Discount Functions** (New feature, 1 Apr 2026): Discount functions now support prerequisites for BXGY discounts allowing developers to specify Buy X conditions in API version 2026-04. - **Add Tags to Discounts** (New feature, 1 Apr 2026): New tags field added to discounts in API version 2026-04 for efficient labeling and organization. - **Adding access field to StandardMetaobjectDefinitionTemplate** (New feature, 1 Apr 2026): New access field added to StandardMetaobjectDefinitionTemplate in API version 2026-07 for visibility of access rules. - **App-owned metaobjects can be used without access scopes** (New feature, 1 Apr 2026): App-owned metaobjects now require no access scopes; ensure Admin API version 2026-04+ for this feature. - **delegateAccessTokenCreate mutation now returns expiresIn** (New feature, 1 Apr 2026): The delegateAccessTokenCreate GraphQL mutation now returns expiresIn field on DelegateAccessToken type. - **Line item component information now available for draft orders on Customer Account API** (New feature, 1 Apr 2026): New components field added to DraftOrderLineItem in API version 2026-04; new optional flattenComponents argument defaults to false. - **Payment method identifier now required for customerPaymentMethodRemoteCreate** (Breaking, 1 Apr 2026): GraphQL Admin API v2026-07 requires payment method ID for Stripe, Authorize.net, and Braintree in customerPaymentMethodRemoteCreate. - **Removing outdated Polaris reference docs** (Other, 1 Apr 2026): Polaris reference docs now align with GraphQL versioning; only last four stable versions will have published docs starting 2026-04. ### March 2026 - **Role-based access control and org management for partners** (New feature, 30 Mar 2026): New RBAC and organization structure for partner organizations with auto-migration starting March 30; no action required. - **The Shopify CLI app release --force flag is deprecated and will be removed** (Deprecation, 25 Mar 2026): The --force flag in Shopify CLI will be removed in May 2026; update CI/CD scripts to use --allow-updates instead. - **Adding barcode support to inventory shipments API** (New feature, 23 Mar 2026): Version 2026-04 adds barcode support to inventory shipments for faster receiving with support for unique barcodes up to 255 characters. - **Removal of pre_tax_price from the Order REST Admin API** (Breaking, 23 Mar 2026): The pre_tax_price fields are removed from REST Admin API; use GraphQL Admin API for order line item pricing instead. - **Updated handling of customer data erasure requests with recent orders** (Other, 23 Mar 2026): Customer data erasure requests will process 10 days after submission regardless of last order date. - **Admin intents now support Settings** (New feature, 20 Mar 2026): Admin intents now support direct access to Shopify Settings pages via API calls. - **Expiring offline access tokens required for new public apps as of April 1, 2026** (Breaking, 20 Mar 2026): Starting April 1, 2026, new public apps must use expiring offline access tokens instead of non-expiring tokens for improved security. - **Process refunds only through the original payment processor** (Other, 20 Mar 2026): Shopify apps must process refunds via the original payment processor using refundCreate or returnProcess. - **Add includeInactive argument to inventoryLevels and inventoryLevel fields** (New feature, 17 Mar 2026): API v2026-04 introduces includeInactive argument for inventoryLevels queries to retrieve inactive inventory while maintaining backward compatibility. - **Add isActive field to InventoryLevel** (New feature, 17 Mar 2026): API version 2026-04 adds isActive field to InventoryLevel, allowing queries for inactive levels without clearing quantities. - **inventoryTransferDelete adds INVALID_STATE error code for transfers with in-progress product import** (New feature, 17 Mar 2026): The inventoryTransferDelete mutation returns INVALID_STATE error in 2026-07 if product import is in progress. - **POS UI extensions can now run without network access** (New feature, 17 Mar 2026): POS UI extensions now run offline when enabled; requires POS v11.0+ and Shopify CLI v3.92+. - **Adding createdAt and updatedAt fields to MetaobjectDefinition objects** (New feature, 16 Mar 2026): The createdAt and updatedAt fields become available in API version 2026-04. - **Making fieldDefinitions optional in metaobjectDefinitionCreate** (New feature, 16 Mar 2026): The fieldDefinitions input argument of metaobjectDefinitionCreate mutation becomes optional in 2026-04. - **New rejection reason codes in Payments Apps API** (New feature, 16 Mar 2026): Payments Apps API now offers detailed decline codes and source field for rejected payments; RISKY code deprecated in favor of FRAUD_SUSPECTED. - **ShopifyQL returns fields deprecated and replaced with sales reversals fields** (Deprecation, 14 Mar 2026): Returns fields in analytics are deprecated in API v2026-04 and replaced with renamed versions (e.g., sales reversals) to better reflect order adjustments. - **Checkout and Customer Account UI extensions available by default in new development shops** (New feature, 13 Mar 2026): New development shops have access to checkout and customer account UI extensions by default. - **inventorySetScheduledChanges mutation is being removed with no replacement** (Breaking, 9 Mar 2026): The inventorySetScheduledChanges mutation is being removed in API version 2026-07; use inventoryAdjustQuantities as an alternative. - **Removed Checkout ID from checkout and order webhooks** (Breaking, 6 Mar 2026): 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 February 2026 update** (New feature, 6 Mar 2026): Shop Minis updates include product tagging for UGC, SafeArea support, CLI commands, improved consent flow, and scope simplification. - **New analyticsQueryable capability for Metafield Definitions** (New feature, 5 Mar 2026): The analyticsQueryable feature enables metafields for Shopify Analytics on Products, Product Variants, Orders, and Customers. - **Bare query strings no longer bust the cache for assets** (Breaking, 2 Mar 2026): Asset caching update ends support for bare query strings for cache busting; use Liquid filters like asset_url instead. - **Enhanced discounts support in the Shopify Functions Cart** (New feature, 2 Mar 2026): In GraphQL API v2026-04, Shopify Functions can access discount details at cart, line item, and delivery levels. ### February 2026 - **Accelerated checkouts now support multiple product variants on the product page** (New feature, 27 Feb 2026): Accelerated checkouts now support purchasing products with add-ons directly from the product page. - **Legacy customer accounts are now deprecated** (Deprecation, 26 Feb 2026): Legacy customer accounts are no longer available to new stores; merchants should upgrade to latest version. - **New APIs to read and write shipping options in delivery profile** (New feature, 24 Feb 2026): New APIs support multiple tiered rates for shipping options; migrate to new fields to avoid future issues. - **Support for market-aware auth URLs in Customer Account API** (New feature, 24 Feb 2026): You can now pass locale and region_country parameters to Customer Account API authorization endpoint for market-aware login URLs. - **Subscriptions APIs** (New feature, 23 Feb 2026): Introduce SubscriptionBillingAttemptState: GraphQL Admin API now includes SubscriptionBillingAttemptState, replacing several fields with discriminated union. - **New rejection reason codes and merchant message added to verificationSessionReject mutation** (New feature, 21 Feb 2026): Payments Apps API now supports new rejection codes and optional merchant message for verification rejections. - **Admin API and bulk operations in Shopify CLI** (New feature, 19 Feb 2026): Shopify CLI 3.90.1 adds commands for executing queries, mutations, and bulk operations, enhancing automation capabilities. - **JSON metafield values limited to 128KB** (Breaking, 19 Feb 2026): Starting with API version 2026-04, JSON metafield values will be capped at 128KB, potentially affecting integrations that store large JSON objects. - **Remaining line items weight available for fulfillment orders** (New feature, 16 Feb 2026): New remainingLineItemsWeight field added to the FulfillmentOrder GraphQL type. - **Added new enum values for ColumnDataType in ShopifyqlTableDataColumn** (New feature, 12 Feb 2026): Added 3 enum values to ColumnDataType: RATING (float), STRING IDENTITY (GID/UUID), COLOR (HEX). - **Webhook subscriptions now support a name field for identification** (New feature, 11 Feb 2026): Webhook subscriptions can now have optional names for easier management; names appear in request headers up to 50 characters. - **shopify.app.extensions() in App Bridge now supports POS UI extensions** (New feature, 9 Feb 2026): The shopify.app.extensions() method in App Bridge now supports Point of Sale UI extensions. - **Shop Minis January 2026 update** (Other, 6 Feb 2026): Shop Minis January 2026 updates include delayed consent popup, curated Explore screen, CLI dashboard command, and privacy controls. - **The GiftCardConfiguration object now includes default gift card expiration** (New feature, 6 Feb 2026): Query gift card expiration settings via GraphQL Admin API with new expirationConfiguration field. - **Automatically copy cart metafields to orders at checkout completion** (New feature, 4 Feb 2026): Order metafield definitions now support cartToOrderCopyable flag; when enabled, cart metafield values copy to matching order metafields. - **Subscriptions APIs** (New feature, 4 Feb 2026): new payment error code and error classification: New payment error codes in Admin GraphQL API enhance diagnosis of subscription billing issues. - **Increasing the app block limit to 30 for theme app extensions** (New feature, 3 Feb 2026): You can now define up to 30 app blocks in your theme app extension, up from 25. - **Introducing the tracks_inventory query filter for products** (New feature, 3 Feb 2026): New tracks_inventory filter added for querying products by inventory tracking status. ### January 2026 - **Ensuring POS UI extension stability by hardening callback handling** (Breaking, 27 Jan 2026): POS version 10.19.0 now displays error page for unhandled callback errors; developers must test callbacks. - **Events data now limited to one year retention** (Breaking, 27 Jan 2026): Access to events data over a year old is removed from Admin GraphQL and REST APIs, affecting long-term data retention. - **New article_list input setting for themes** (New feature, 26 Jan 2026): Theme developers can now use article_list setting type to let merchants select multiple blog articles for sections and blocks. - **More control over app deploys in CI/CD** (New feature, 23 Jan 2026): Shopify CLI 3.89 adds --allow-updates and --allow-deletes flags for safer app deployment control in CI/CD pipelines. ### December 2025 - **Removing permitsSkuSharing field from fulfillment service** (Breaking, 19 Dec 2025): In API version 2026-04, permitsSkuSharing is removed from FulfillmentService with SKU sharing enabled by default. ## Other APIs we monitor - [Airtable](https://seamless.engineering/api-changelog/airtable/) - [Brevo](https://seamless.engineering/api-changelog/brevo/) - [DATEV](https://seamless.engineering/api-changelog/datev/) - [Discord](https://seamless.engineering/api-changelog/discord/) - [Google Sheets](https://seamless.engineering/api-changelog/google-sheets/) - [HubSpot](https://seamless.engineering/api-changelog/hubspot/) - [Jira Cloud](https://seamless.engineering/api-changelog/jira/) - [lexoffice](https://seamless.engineering/api-changelog/lexoffice/) - [Linear](https://seamless.engineering/api-changelog/linear/) - [Monday.com](https://seamless.engineering/api-changelog/monday/) - [Notion](https://seamless.engineering/api-changelog/notion/) - [Personio](https://seamless.engineering/api-changelog/personio/) - [Pinterest API](https://seamless.engineering/api-changelog/pinterest/) - [Pipedrive](https://seamless.engineering/api-changelog/pipedrive/) - [Salesforce](https://seamless.engineering/api-changelog/salesforce/) - [Slack](https://seamless.engineering/api-changelog/slack/) - [Stripe](https://seamless.engineering/api-changelog/stripe/) - [Xentral](https://seamless.engineering/api-changelog/xentral/) - [Zendesk](https://seamless.engineering/api-changelog/zendesk/) ## Frequently asked questions ### Has the Shopify API had breaking changes recently? Yes: 9 breaking changes and 2 deprecations in the last 90 days. The most recent is “automaticDiscounts query is removed in API version 2027-01” from 18 September 2026. ### How often does the Shopify API change? Over the period on record, Shopify published about 17 changelog entries a month. Most are additions; the breaking changes and deprecations are the ones to plan for. ### Where is the official Shopify API changelog? Shopify publishes it at https://shopify.dev/changelog?filter=api. This page follows it daily and dates each entry. ### How do I get notified about Shopify API changes? Subscribe to this page's RSS feed (https://seamless.engineering/api-changelog/shopify/rss.xml). If you would rather have someone act on them, we operate Shopify integrations and handle changes like these before they reach production. ## Request a scoping call 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. - Email: hello@seamless.engineering - Contact form: https://seamless.engineering/#contact