--- 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) * February 16, 2026 Tags: * Admin GraphQL API * 2026-04 ### [Remaining line items weight available for fulfillment orders](https://shopify.dev/changelog/remaining-line-items-weight-available-for-fulfillment-orders) A new remainingLineItemsWeight field has been added to the FulfillmentOrder GraphQL type. [Read full post –>](https://shopify.dev/changelog/remaining-line-items-weight-available-for-fulfillment-orders) * February 12, 2026 Tags: * Admin GraphQL API * 2026-04 ### [Added new enum values for ColumnDataType in ShopifyqlTableDataColumn](https://shopify.dev/changelog/added-new-enum-values-for-columndatatype-in-shopifyqltabledatacolumn) Added 3 enum values to ColumnDataType: RATING (float), STRING IDENTITY (GID/UUID), COLOR (HEX). Enhances data representation flexibility for developers. [Read full post –>](https://shopify.dev/changelog/added-new-enum-values-for-columndatatype-in-shopifyqltabledatacolumn) * February 11, 2026 Tags: * Admin GraphQL API * Webhook * 2026-04 ### [Webhook subscriptions now support a name field for identification](https://shopify.dev/changelog/webhook-subscriptions-now-support-a-name-field-for-identification) Assign optional names to webhook subscriptions for easier management. Names appear in request headers, aiding routing. Unique per shop/app, up to 50 chars, set via TOML or Admin API. [Read full post –>](https://shopify.dev/changelog/webhook-subscriptions-now-support-a-name-field-for-identification) * February 6, 2026 Tags: * Admin GraphQL API * 2026-04 ### [The `GiftCardConfiguration` object now includes default gift card expiration](https://shopify.dev/changelog/giftcardconfiguration-now-includes-default-gift-card-expiration) Query gift card expiration settings via GraphQL Admin API. New `expirationConfiguration` field provides duration and unit, aiding in calculating expiration dates for gift cards. [Read full post –>](https://shopify.dev/changelog/giftcardconfiguration-now-includes-default-gift-card-expiration) * February 4, 2026 Tags: * Admin GraphQL API * 2026-04 ### [Subscriptions APIs: new payment error code and error classification](https://shopify.dev/changelog/new-payment-error-codes-added-to-subscriptions-apis) New payment error codes in Admin GraphQL API enhance diagnosis. Unstable API version shows fewer generic errors. Temporary error mapping issue fixed. [Read full post –>](https://shopify.dev/changelog/new-payment-error-codes-added-to-subscriptions-apis) * February 4, 2026 Tags: * Admin GraphQL API * 2026-04 ### [Automatically copy cart metafields to orders at checkout completion](https://shopify.dev/changelog/automatically-copy-cart-metafields-to-orders-at-checkout-completion) Order metafield definitions now support `cartToOrderCopyable`. When enabled, cart metafield values copy to the matching order metafields at checkout completion. [Read full post –>](https://shopify.dev/changelog/automatically-copy-cart-metafields-to-orders-at-checkout-completion) * February 3, 2026 Tags: * Admin GraphQL API * 2026-04 ### [Introducing the `tracks_inventory` query filter for products](https://shopify.dev/changelog/introducing-tracksinventory-query-filter-for-products) We've added a `tracks_inventory` filter for querying products by inventory tracking status. [Read full post –>](https://shopify.dev/changelog/introducing-tracksinventory-query-filter-for-products) * January 29, 2026 Tags: * Admin GraphQL API ### [Discouraging use of `receiptJson` on `OrderTransaction` in the GraphQL Admin API](https://shopify.dev/changelog/discouraging-use-of-receiptjson-on-ordertransaction-in-the-graphql-admin-api) Avoid using `OrderTransaction.receiptJson` due to its instability and inconsistent structure. Migrate to stable fields to prevent app failures. [Read full post –>](https://shopify.dev/changelog/discouraging-use-of-receiptjson-on-ordertransaction-in-the-graphql-admin-api) * January 27, 2026 Tags: * Admin GraphQL API * Admin REST API ### [Events data now limited to one year retention](https://shopify.dev/changelog/events-data-now-limited-to-one-year-retention) Access to events data over a year old is removed from Admin GraphQL and REST APIs. Update dependencies to ensure compatibility. This change enhances data management and system performance. [Read full post –>](https://shopify.dev/changelog/events-data-now-limited-to-one-year-retention) * January 17, 2026 Tags: * Admin GraphQL API * Admin REST API * 2026-04 ### [`inventoryActivate` now preserves `available` quantity](https://shopify.dev/changelog/inventoryactivate-now-preserves-available-quantity) In API 2026-04, `inventoryActivate` now preserves existing `active` and `onHand` quantities if `available` or `onHand` aren't provided, preventing unwanted resets to zero. [Read full post –>](https://shopify.dev/changelog/inventoryactivate-now-preserves-available-quantity) * January 8, 2026 Tags: * Admin GraphQL API * 2026-04 ### [Deprecated `deliveryShippingOriginAssign` mutation](https://shopify.dev/changelog/deprecate-deliveryshippingoriginassign-mutation) The deliveryShippingOriginAssign mutation is being deprecated. [Read full post –>](https://shopify.dev/changelog/deprecate-deliveryshippingoriginassign-mutation) * January 1, 2026 Tags: * Admin GraphQL API * 2026-01 ### [`INVALID_BILLING_ADDRESS`: new processing error for subscription billing attempts](https://shopify.dev/changelog/subscription-billing-attempt-invalid-billing-address-error) New error INVALID\_BILLING\_ADDRESS for subscription billing attempts flags invalid billing address fields. [Read full post –>](https://shopify.dev/changelog/subscription-billing-attempt-invalid-billing-address-error) * January 1, 2026 Tags: * Admin GraphQL API * 2026-01 ### [Access transactions on the Return object](https://shopify.dev/changelog/access-transactions-on-the-return-object) The Admin GraphQL API now includes a `transactions` connection in the `Return` object, simplifying payment/refund associations for returns, enhancing financial reporting accuracy. [Read full post –>](https://shopify.dev/changelog/access-transactions-on-the-return-object) * January 1, 2026 Tags: * Admin GraphQL API * Webhook * 2026-01 ### [Introducing the `orders/link_requested` webhook topic](https://shopify.dev/changelog/introducing-the-orderslinkrequested-webhook-topic) API v2026-01 adds an `orders/link_requested` webhook, notifying subscribed apps when customers request new order links from expired **Order status** pages. [Read full post –>](https://shopify.dev/changelog/introducing-the-orderslinkrequested-webhook-topic) * January 1, 2026 Tags: * Admin GraphQL API * Customer Account API * Webhook * 2026-01 ### [New Return Reason Definitions API for Better Return Insights](https://shopify.dev/changelog/new-return-reason-definitions-api-for-better-return-insights) A new `ReturnReasonDefinition` type replaces `ReturnReason`, providing category-specific return reasons for better analytics and improved return experiences. [Read full post –>](https://shopify.dev/changelog/new-return-reason-definitions-api-for-better-return-insights) * January 1, 2026 Tags: * Admin GraphQL API * 2026-01 ### [Subscription billing attempts throttling](https://shopify.dev/changelog/subscription-billing-attempts-throttling) We're introducing throttling for billing attempts, with errors visible in the `throttled` code on the `BillingAttemptUserErrorCode` code. [Read full post –>](https://shopify.dev/changelog/subscription-billing-attempts-throttling) * December 22, 2025 Tags: * Action Required * Admin GraphQL API * 2026-01 ### [Deprecation of `Shop.billingAddress` in favor of `Shop.shopAddress`](https://shopify.dev/changelog/deprecation-of-shop-billingaddress-in-favor-of-shop-shopaddress) API version 2026-01 introduces `shopAddress` in `Shop` object, replacing `billingAddress`. Update queries to use `shopAddress` for future compatibility. Structure remains unchanged. [Read full post –>](https://shopify.dev/changelog/deprecation-of-shop-billingaddress-in-favor-of-shop-shopaddress) * December 19, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Conversion tracking fields added to MarketingEngagementCreate](https://shopify.dev/changelog/conversion-tracking-fields-added-to-marketing-engagement-create) New fields in `MarketingEngagementCreate` enhance data integration for marketing metrics, supporting diverse conversion tracking and analytics in Shopify's reports. [Read full post –>](https://shopify.dev/changelog/conversion-tracking-fields-added-to-marketing-engagement-create) * December 19, 2025 Tags: * Action Required * Admin GraphQL API * Admin REST API * 2026-04 ### [Removing `permitsSkuSharing` field from fulfillment service](https://shopify.dev/changelog/removing-permitsskusharing-field-from-fulfillment-service) In API version 2026-04, `permitsSkuSharing` is removed from `FulfillmentService`. Permits SKU sharing will be enabled by default. [Read full post –>](https://shopify.dev/changelog/removing-permitsskusharing-field-from-fulfillment-service) * December 18, 2025 Tags: * Action Required * Admin GraphQL API ### [Customer marketing URL fields now require write access](https://shopify.dev/changelog/customer-marketing-url-fields-now-require-write-access) Customer-related fields now require `write_customers` scope and `create_and_edit_customers` permission due to security fixes. Update apps to avoid access denied errors. [Read full post –>](https://shopify.dev/changelog/customer-marketing-url-fields-now-require-write-access) * December 16, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Set and retrieve `processedAt` in the `refundCreate` mutation](https://shopify.dev/changelog/set-processed-at-in-refund-create) The `refundCreate` mutation now supports an optional `processedAt` field. [Read full post –>](https://shopify.dev/changelog/set-processed-at-in-refund-create) * December 15, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Faster bulk operations](https://shopify.dev/changelog/faster-bulk-operations) Shopify's bulk operations API now supports all Admin API mutations, allows 100MB file uploads, and enables five concurrent operations, enhancing speed and efficiency for developers. [Read full post –>](https://shopify.dev/changelog/faster-bulk-operations) * 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-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 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 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 5, 2025 Tags: * Admin GraphQL API ### [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 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 8, 2025 Tags: * Admin GraphQL API * 2026-04 ### [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) * 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)