--- title: Recent changes to Shopify’s platform description: Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities. source_url: html: https://shopify.dev/changelog?api_type=admin-graphql md: https://shopify.dev/changelog.md?api_type=admin-graphql --- # Developer changelog Subscribe to the changelog to stay up to date on recent changes to Shopify’s APIs and other developer products, as well as preview upcoming features and beta releases. [RSS Updates](https://shopify.dev/changelog/feed.xml) * December 12, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Improved compare and swap inventory updates for the `inventorySetQuantities` mutation](https://shopify.dev/changelog/compare-and-swap-redesign-for-inventory-set-quantities) `inventorySetQuantities` now supports a cleaner way to handle concurrent updates. Use the new `changeFromQuantity` field instead of the deprecated `compareQuantity` and `ignoreCompareQuantity` fields. [Read full post –>](https://shopify.dev/changelog/compare-and-swap-redesign-for-inventory-set-quantities) * December 12, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Adding idempotency for inventory adjustments and refund mutations](https://shopify.dev/changelog/adding-idempotency-for-inventory-adjustments-and-refund-mutations) Idempotency keys are now available on refund and inventory mutations starting in API version 2026-01, enabling safer request retries and preventing duplicate operations. [Read full post –>](https://shopify.dev/changelog/adding-idempotency-for-inventory-adjustments-and-refund-mutations) * December 12, 2025 Tags: * Admin GraphQL API * 2026-01 ### [New `changeFromQuantity` field to manage inventory](https://shopify.dev/changelog/compare-and-swap-for-inventory-mutations-with-change-from-quantity) The `changeFromQuantity` field ensures inventory data stays accurate, even if you're making multiple adjustments at the same time. [Read full post –>](https://shopify.dev/changelog/compare-and-swap-for-inventory-mutations-with-change-from-quantity) * December 12, 2025 Tags: * Admin GraphQL API ### [Deprecation of `OrderTransaction.authorizationCode` in favor of `OrderTransaction.paymentId`](https://shopify.dev/changelog/deprecation-of-ordertransaction-authorizationcode-in-favor-of-ordertransactionpaymentid) From API version `2026-01`, `authorizationCode` in `OrderTransaction` is deprecated. Use `paymentId` for stable payment tracking. Update queries to replace `authorizationCode` with `paymentId`. [Read full post –>](https://shopify.dev/changelog/deprecation-of-ordertransaction-authorizationcode-in-favor-of-ordertransactionpaymentid) * December 12, 2025 Tags: * Action Required * Admin GraphQL API * 2026-04 ### [New compare and swap syntax for the `inventorySetQuantities` mutation](https://shopify.dev/changelog/finalizing-compare-and-swap-redesign-for-inventory-set-quantities) The `changeFromQuantity` field is now mandatory; use `null` to bypass checks. `compareQuantity` and `ignoreCompareQuantity` fields are removed, impacting inventory mutation handling. [Read full post –>](https://shopify.dev/changelog/finalizing-compare-and-swap-redesign-for-inventory-set-quantities) * December 12, 2025 Tags: * Action Required * Admin GraphQL API * 2026-01 ### [Concurrency protection features for inventory and refund mutations](https://shopify.dev/changelog/concurrency-protection-features) New concurrency protection features: `changeFromQuantity` field and `idempotent` directive will be required for inventory and refund mutations. Breaking changes. [Read full post –>](https://shopify.dev/changelog/concurrency-protection-features) * December 12, 2025 Tags: * Action Required * Admin GraphQL API * 2026-04 ### [Making `changeFromQuantity` field required (with explicit opt-out)](https://shopify.dev/changelog/making-changefromquantity-field-required) Starting April 2026, `changeFromQuantity` is required for inventory mutations. This ensures data accuracy by preventing overwrites if quantities change concurrently. Use `null` to opt-out. [Read full post –>](https://shopify.dev/changelog/making-changefromquantity-field-required) * December 12, 2025 Tags: * Action Required * Admin GraphQL API * 2026-04 ### [Making idempotency mandatory for inventory adjustments and refund mutations](https://shopify.dev/changelog/making-idempotency-mandatory-for-inventory-adjustments-and-refund-mutations) Starting April 2026, idempotency is mandatory for specific Shopify mutations to prevent duplicate inventory adjustments and refunds, enhancing integration robustness and reducing errors. [Read full post –>](https://shopify.dev/changelog/making-idempotency-mandatory-for-inventory-adjustments-and-refund-mutations) * December 10, 2025 Tags: * Admin GraphQL API * 2026-01 ### [New fields to combine bundle options](https://shopify.dev/changelog/new-fields-to-combine-bundle-options) Support merchants in combining options, such as size and length, so customers have fewer clicks to checkout. [Read full post –>](https://shopify.dev/changelog/new-fields-to-combine-bundle-options) * December 10, 2025 Tags: * Admin GraphQL API * Admin REST API ### [Offline access tokens now support expiry and refresh](https://shopify.dev/changelog/offline-access-tokens-now-support-expiry-and-refresh) Offline access tokens now expire in 60 minutes and include a refresh token for renewal, enhancing security and aligning with OAuth 2.0. Update token management to handle expirations. [Read full post –>](https://shopify.dev/changelog/offline-access-tokens-now-support-expiry-and-refresh) * December 10, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Advanced Metafield & Metaobject Querying](https://shopify.dev/changelog/advanced-metafield-metaobject-querying) Developers can now query Products, Orders, and Metaobjects using advanced Metafield filters like greater/less than, prefix, and boolean logic, streamlining resource searches. [Read full post –>](https://shopify.dev/changelog/advanced-metafield-metaobject-querying) * December 9, 2025 Tags: * Admin GraphQL API * Webhook * 2026-01 ### [Tax summary webhook and calculation requests now include customer and company metafields](https://shopify.dev/changelog/tax-summary-webhook-and-calculation-requests-now-include-customer-and-company-metafields) API version 2026-01 adds buyer metafields to tax requests, enabling tax partners to use custom customer and company data for precise tax calculations and compliance in D2C and B2B orders. [Read full post –>](https://shopify.dev/changelog/tax-summary-webhook-and-calculation-requests-now-include-customer-and-company-metafields) * December 5, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Order editing new validations and handled `userErrors`](https://shopify.dev/changelog/order-editing-new-validations-and-handled-usererrors) New order editing validations have been introduced [Read full post –>](https://shopify.dev/changelog/order-editing-new-validations-and-handled-usererrors) * December 2, 2025 Tags: * Admin GraphQL API * 2026-01 ### [InventoryItem.variant field deprecated in favor of InventoryItem.variants connection](https://shopify.dev/changelog/inventory-item-variant-field-deprecation) The InventoryItem.variant field is deprecated; switch to InventoryItem.variants for paginated connections. Update queries to handle edges and nodes for future compatibility. [Read full post –>](https://shopify.dev/changelog/inventory-item-variant-field-deprecation) * November 22, 2025 Tags: * Admin GraphQL API * Webhook * 2026-01 ### [Tax summary webhook and calculation requests now includes shop and presentment currency amount](https://shopify.dev/changelog/tax-summary-webhook-and-calculation-requests-now-includes-shop-and-presentment-currency-amount) API v2026-01 adds currency fields to `tax_summaries/create` webhook for shop and presentment currencies, enhancing multi-currency reporting and calculations for Tax Partner Apps. [Read full post –>](https://shopify.dev/changelog/tax-summary-webhook-and-calculation-requests-now-includes-shop-and-presentment-currency-amount) * November 20, 2025 Tags: * Action Required * Webhook * Admin GraphQL API * 2026-01 ### [Tax summary webhook `created_at` field now returns UTC timezone](https://shopify.dev/changelog/tax-summary-webhook-created-at-field-now-returns-utc-timezone) The `created_at` field now returns UTC format, improving consistency across systems. Developers should update parsing logic to handle the new format starting January 2026. [Read full post –>](https://shopify.dev/changelog/tax-summary-webhook-created-at-field-now-returns-utc-timezone) * November 12, 2025 Tags: * Action Required * Admin GraphQL API * Webhook * 2026-01 ### [Tax webhook summary and calculation requests now use Global IDs](https://shopify.dev/changelog/tax-webhook-summary-and-calculation-requests-now-use-global-ids) Third-party tax apps now receive Global IDs for entity identification, aligning with Shopify's GraphQL Admin API standards. [Read full post –>](https://shopify.dev/changelog/tax-webhook-summary-and-calculation-requests-now-use-global-ids) * November 5, 2025 Tags: * Admin GraphQL API * Webhook * 2026-01 ### [tax\_summaries/create webhook and taxSummaryCreate mutation now available](https://shopify.dev/changelog/taxsummariescreate-webhook-and-taxsummarycreate-mutation-now-available) The 2026-01 API adds `taxSummaryCreate` mutation for generating tax summaries and `tax_summaries/create` webhook for tax events. Requires `write_taxes` scope and Tax Platform access. [Read full post –>](https://shopify.dev/changelog/taxsummariescreate-webhook-and-taxsummarycreate-mutation-now-available) * November 4, 2025 Tags: * Admin GraphQL API ### [Carrier Service API now includes order totals and customer tags](https://shopify.dev/changelog/carrier-service-api-now-includes-order-totals-and-customer-tags) The Carrier Service API now includes `order_totals` and `customer tags` in callbacks, enabling more precise shipping rate calculations based on order value and customer segmentation. [Read full post –>](https://shopify.dev/changelog/carrier-service-api-now-includes-order-totals-and-customer-tags) * November 1, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Order Update Phone Field Public](https://shopify.dev/changelog/order-update-phone-field-public) Admin API 2026-01 update: `phone` field in `orderUpdate` mutation's `OrderInput` is now public, enabling developers to update customer phone numbers, aligning with REST API capabilities. [Read full post –>](https://shopify.dev/changelog/order-update-phone-field-public) * October 31, 2025 Tags: * Admin GraphQL API * 2026-01 ### [New Queries for Bulk Operations](https://shopify.dev/changelog/new-queries-for-bulk-operations) New GraphQL queries `bulkOperations` and `bulkOperation` enhance bulk operation management with filtering, sorting, and pagination, improving visibility and debugging in the Admin API. [Read full post –>](https://shopify.dev/changelog/new-queries-for-bulk-operations) * October 29, 2025 Tags: * Action Required * Admin GraphQL API * 2026-01 ### [Bulk operations group objects default changed to `false`](https://shopify.dev/changelog/bulk-operations-group-objects-default-changed-to-false) GraphQL Admin API bulk operations are now faster and more reliable. `groupObjects` defaults to `false` for queries and is deprecated for mutations. Adjust settings for grouped output if needed. [Read full post –>](https://shopify.dev/changelog/bulk-operations-group-objects-default-changed-to-false) * October 27, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Optional location inputs for inventory transfers](https://shopify.dev/changelog/optional-location-inputs-for-inventory-transfers) Inventory transfers can now omit origin or destination IDs, enhancing flexibility. Update app validation to treat these fields as optional. Existing apps remain unaffected. [Read full post –>](https://shopify.dev/changelog/optional-location-inputs-for-inventory-transfers) * October 24, 2025 Tags: * Admin GraphQL API * 2026-01 ### [New ACH support for deferred payments](https://shopify.dev/changelog/new-ach-support-for-deferred-payments) The 2026-01 Admin GraphQL API adds ACH payment support, introducing `BankAccount` to `PaymentInstrument` and `CustomerPaymentInstrument` unions, enhancing B2B payment management. [Read full post –>](https://shopify.dev/changelog/new-ach-support-for-deferred-payments) * October 24, 2025 Tags: * Platform * Admin GraphQL API * Admin REST API ### [Increased limits in metafield and metaobject definitions](https://shopify.dev/changelog/increased-limits-for-metafields-and-metaobjects) Increased metafield and metaobject limits: 256 app definitions, 256 merchant definitions, and 1M entries per definition, supporting complex data models and workflows. [Read full post –>](https://shopify.dev/changelog/increased-limits-for-metafields-and-metaobjects) * October 23, 2025 Tags: * Admin GraphQL API * 2026-01 ### [New `notify` parameter available on the `storeCreditAccountCredit` mutation](https://shopify.dev/changelog/store-credit-notify-flag) The `storeCreditAccountCredit` mutation now accepts an optional `notify` parameter. When set to `true` the account owner will be sent a 'store credit issued email'. [Read full post –>](https://shopify.dev/changelog/store-credit-notify-flag) * October 21, 2025 Tags: * Admin GraphQL API * Admin REST API * Webhook * Liquid * Storefront GraphQL API ### [New: Unlisted Product Status](https://shopify.dev/changelog/new-unlisted-product-status) The "Unlisted" product status is now in the 2025-10 Admin APIs, making products only accessible via a direct URL. [Read full post –>](https://shopify.dev/changelog/new-unlisted-product-status) * October 13, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Fulfillment service callback url is now optional](https://shopify.dev/changelog/fulfillment-service-callback-url-is-now-optional) Admin API 2026-01: `callbackUrl` in `fulfillmentServiceCreate` and `fulfillmentServiceUpdate` is now optional. Existing fulfillment services will be unaffected. [Read full post –>](https://shopify.dev/changelog/fulfillment-service-callback-url-is-now-optional) * October 10, 2025 Tags: * Action Required * Admin GraphQL API * 2026-01 ### [Removing `visible_to_storefront_api` field on metaobject field definitions](https://shopify.dev/changelog/removing-storefront-visibility-field-on-metaobject-field-definitions) The `visible_to_storefront_api` field is deprecated and removed. Use the `access` input field to configure storefront accessibility of metaobjects. [Read full post –>](https://shopify.dev/changelog/removing-storefront-visibility-field-on-metaobject-field-definitions) * October 8, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Deprecate delivery legacy modes fields](https://shopify.dev/changelog/deprecate-delivery-legacy-modes-fields) Legacy mode profiles are no longer supported. [Read full post –>](https://shopify.dev/changelog/deprecate-delivery-legacy-modes-fields) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [New: Support for USDC Credit field in Shopify Payments Payout GraphQL](https://shopify.dev/changelog/new-support-for-usdc-credit-field-in-shopify-payments-payout-graphql) GraphQL Admin API 2025-10 adds `usdcRebateCreditAmount` to ShopifyPaymentsPayoutSummary, providing a total of all usdc rebate credits issued as part of the payout. [Read full post –>](https://shopify.dev/changelog/new-support-for-usdc-credit-field-in-shopify-payments-payout-graphql) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Rerouting Fulfillment Orders is now possible via API](https://shopify.dev/changelog/rerouting-fulfillment-orders-via-api) The `fulfillmentOrdersReroute` mutation in the Admin GraphQL API lets developers reroute orders based on delivery strategies, enhancing flexibility and consistency. [Read full post –>](https://shopify.dev/changelog/rerouting-fulfillment-orders-via-api) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Subscription contract shipping requirements now sync with product variants](https://shopify.dev/changelog/subscription-contract-shipping-requirements-now-sync-with-product-variants) Subscription contracts now sync shipping requirements from product variants and skip delivery lines for digital orders, ensuring accurate taxes and totals. [Read full post –>](https://shopify.dev/changelog/subscription-contract-shipping-requirements-now-sync-with-product-variants) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [New `productNetwork` field on the `Order` object](https://shopify.dev/changelog/new-productnetwork-field-on-order-object) The Order object now includes a productNetwork boolean field (2025-10) to identify orders created through the Product Network. [Read full post –>](https://shopify.dev/changelog/new-productnetwork-field-on-order-object) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [`productSet` mutation now validates `inventoryQuantities` limits](https://shopify.dev/changelog/productset-limit-for-inventory-quantities) The `productSet` mutation now enforces validation limits on inventory quantities as part of supporting the increased variant limit from 100 to 2048 variants per product. [Read full post –>](https://shopify.dev/changelog/productset-limit-for-inventory-quantities) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Dynamic complexity cost for `productCreate` and `productUpdate` mutations](https://shopify.dev/changelog/dynamic-complexity-cost-for-productcreate-and-productupdate-mutations) The `productCreate` and `productUpdate` mutations now use dynamic complexity costing that more accurately reflects the actual computational cost of operations. [Read full post –>](https://shopify.dev/changelog/dynamic-complexity-cost-for-productcreate-and-productupdate-mutations) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [`productVariantsBulkCreate` and `productVariantsBulkUpdate` mutations now validate `inventoryQuantities` limits](https://shopify.dev/changelog/inventoryquantities-limit-in-mutations) The `productVariantsBulkCreate` and `productVariantsBulkUpdate` mutations now validate limits on inventory quantities to support increased variant limit from 100 to 2048 variants per product. [Read full post –>](https://shopify.dev/changelog/inventoryquantities-limit-in-mutations) * October 1, 2025 Tags: * Admin GraphQL API ### [Dynamic complexity for `productVariantsBulkCreate` and `productVariantsBulkUpdate` mutations](https://shopify.dev/changelog/dynamic-complexity-for-productvariantsbulkcreate-and-productvariantsbulkupdate-mutations) The `productVariantsBulkCreate` and `productVariantsBulkUpdate` mutations now use dynamic complexity costing that more accurately reflects the actual computational cost of operations. [Read full post –>](https://shopify.dev/changelog/dynamic-complexity-for-productvariantsbulkcreate-and-productvariantsbulkupdate-mutations) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Dynamic complexity cost for `productSet` mutation](https://shopify.dev/changelog/dynamic-complexity-cost-for-productset-mutation) The `productSet` mutation now uses dynamic complexity costing that more accurately reflects the actual computational cost of operations. [Read full post –>](https://shopify.dev/changelog/dynamic-complexity-cost-for-productset-mutation) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [ShopifyQL now available as `shopifyqlQuery` within the GraphQL Admin API](https://shopify.dev/changelog/shopifyqlquery-now-available-in-graphql-admin-api) Adds query field `shopifyqlQuery` to GraphQL Admin API [Read full post –>](https://shopify.dev/changelog/shopifyqlquery-now-available-in-graphql-admin-api) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Duplicate themes with the Admin GraphQL API](https://shopify.dev/changelog/duplicate-themes-with-the-admin-graphql-api) The new `themeDuplicate` mutation in Admin GraphQL API allows you to duplicate themes (and optionally rename the duplicate). [Read full post –>](https://shopify.dev/changelog/duplicate-themes-with-the-admin-graphql-api) * September 30, 2025 Tags: * Action Required * Admin GraphQL API ### [Upcoming Markets pricing support for Draft Order checkouts](https://shopify.dev/changelog/upcoming-markets-pricing-support-for-draft-order-checkouts) From October 31 2025, updating a shipping address in Draft Order checkout may alter prices based on Markets settings. Use `priceOverride` or `generatePriceOverride` to maintain prices. [Read full post –>](https://shopify.dev/changelog/upcoming-markets-pricing-support-for-draft-order-checkouts) * September 26, 2025 Tags: * Action Required * Admin GraphQL API * 2026-01 ### [Removal of deprecated `Shop.draftOrders` connection in the GraphQL Admin API](https://shopify.dev/changelog/removal-of-deprecated-shopdraftorders-connection-in-admin-graphql-api) The `Shop.draftOrders` connection is removed in GraphQL Admin API v2026-01. Use `QueryRoot.draftOrders` to access multiple draft orders. [Read full post –>](https://shopify.dev/changelog/removal-of-deprecated-shopdraftorders-connection-in-admin-graphql-api) * September 23, 2025 Tags: * Admin GraphQL API * Liquid * Storefront GraphQL API * 2025-10 ### [New metafield definition types in GraphQL - article\_reference / list.article\_reference](https://shopify.dev/changelog/new-metafield-definition-types-in-graphql-articlereference-listarticlereference) Shopify's Admin GraphQL API now supports `article_reference` and `list.article_reference` metafield types, enabling dynamic content linking and improved store customization. [Read full post –>](https://shopify.dev/changelog/new-metafield-definition-types-in-graphql-articlereference-listarticlereference) * September 18, 2025 Tags: * Admin GraphQL API ### [Added support for dispute preventions](https://shopify.dev/changelog/adds-support-for-dispute-preventions) Adds a new 'prevented' status for Disputes and updates the description of all dispute statuses. [Read full post –>](https://shopify.dev/changelog/adds-support-for-dispute-preventions) * September 17, 2025 Tags: * Admin GraphQL API * Customer Account API * 2025-10 ### [New balance and due status fields for PaymentSchedule](https://shopify.dev/changelog/new-balance-and-due-status-fields-for-paymentschedule) You can now access more detailed balance information and due status for payment schedules with three new fields: balanceDue, totalBalance, and due. [Read full post –>](https://shopify.dev/changelog/new-balance-and-due-status-fields-for-paymentschedule) * September 15, 2025 Tags: * Admin GraphQL API ### [Enhanced API stability with rate limiting for remote payment method creation](https://shopify.dev/changelog/enhanced-api-stability-with-rate-limiting-for-remote-payment-method-creation) The customerPaymentMethodRemoteCreate mutation now has rate limiting to control API usage, ensuring stable performance for all merchants. [Read full post –>](https://shopify.dev/changelog/enhanced-api-stability-with-rate-limiting-for-remote-payment-method-creation) * September 12, 2025 Tags: * Admin GraphQL API ### [Facebook (Meta) orders support native exchanges](https://shopify.dev/changelog/facebook-meta-orders-support-native-exchanges) As of Aug 26, 2025, `exchangeLineItems` and return fees are supported for new Facebook orders via `returnCreate` mutation, simplifying exchanges. Not applicable to prior orders. [Read full post –>](https://shopify.dev/changelog/facebook-meta-orders-support-native-exchanges) * September 10, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Metaobject field definitions offer new capabilities](https://shopify.dev/changelog/metaobject-field-capabilities) Version 2025-10 allows metaobject fields to include capabilities like `admin_filterable`, enabling filtering in Shopify admin. [Read full post –>](https://shopify.dev/changelog/metaobject-field-capabilities) * May 21, 2025 Tags: * Action Required * Admin GraphQL API * 2025-07 ### [Deprecation of legacy return APIs and improvements to return management](https://shopify.dev/changelog/deprecation-of-legacy-return-apis-and-improvements-to-return-management) Shopify Admin API updates: returnRefund deprecated, replaced by returnProcess for streamlined return management. Available now in unstable, official release in 2025-07. [Read full post –>](https://shopify.dev/changelog/deprecation-of-legacy-return-apis-and-improvements-to-return-management) [Next](https://shopify.dev/changelog?api_type=admin-graphql\&page=2)