--- 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&api_version=2026-01 md: https://shopify.dev/changelog.md?api_type=admin-graphql&api_version=2026-01 --- # 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) * 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 * 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) * 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: * Customer Account API * Admin GraphQL API * 2026-01 ### [Metafield references added to Customer Account API](https://shopify.dev/changelog/metafield-references-added-to-customer-account-api) Added `metafield.reference`(s) to the Customer Account API, along with granular Admin API metaobject access controls, enabling the Customer Account API to query `Media` types and metaobjects. [Read full post –>](https://shopify.dev/changelog/metafield-references-added-to-customer-account-api) * January 1, 2026 Tags: * Admin GraphQL API * 2026-01 ### [Due on Fulfillment payment term available for pre-orders](https://shopify.dev/changelog/due-on-fulfillment-payment-term-available-for-pre-orders) Added `ON_FULFILLMENT` to SellingPlanRemainingBalanceChargeTrigger to set payment for pre-orders due upon order fulfillment. [Read full post –>](https://shopify.dev/changelog/due-on-fulfillment-payment-term-available-for-pre-orders) * 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 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: * 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 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 * 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 * 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 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 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 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) * 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)