Developer changelog

We're introducing throttling for billing attempts, with errors visible in the throttled code on the BillingAttemptUserErrorCode code.

API v2026-01 adds an orders/link_requested webhook, notifying subscribed apps when customers request new order links from expired Order status pages.

A new ReturnReasonDefinition type replaces ReturnReason, providing category-specific return reasons for better analytics and improved return experiences.

The Admin GraphQL API now includes a transactions connection in the Return object, simplifying payment/refund associations for returns, enhancing financial reporting accuracy.

New error INVALID_BILLING_ADDRESS for subscription billing attempts flags invalid billing address fields.

Added ON_FULFILLMENT to SellingPlanRemainingBalanceChargeTrigger to set payment for pre-orders due upon order fulfillment.

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.

API version 2026-01 introduces shopAddress in Shop object, replacing billingAddress. Update queries to use shopAddress for future compatibility. Structure remains unchanged.

New fields in MarketingEngagementCreate enhance data integration for marketing metrics, supporting diverse conversion tracking and analytics in Shopify's reports.

The refundCreate mutation now supports an optional processedAt field.

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.

New concurrency protection features: changeFromQuantity field and idempotent directive will be required for inventory and refund mutations. Breaking changes.

Idempotency keys are now available on refund and inventory mutations starting in API version 2026-01, enabling safer request retries and preventing duplicate operations.

The changeFromQuantity field ensures inventory data stays accurate, even if you're making multiple adjustments at the same time.

inventorySetQuantities now supports a cleaner way to handle concurrent updates. Use the new changeFromQuantity field instead of the deprecated compareQuantity and ignoreCompareQuantity fields.

Developers can now query Products, Orders, and Metaobjects using advanced Metafield filters like greater/less than, prefix, and boolean logic, streamlining resource searches.

Support merchants in combining options, such as size and length, so customers have fewer clicks to checkout.

The InventoryItem.variant field is deprecated; switch to InventoryItem.variants for paginated connections. Update queries to handle edges and nodes for future compatibility.

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.

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.

Third-party tax apps now receive Global IDs for entity identification, aligning with Shopify's GraphQL Admin API standards.

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.

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.

New GraphQL queries bulkOperations and bulkOperation enhance bulk operation management with filtering, sorting, and pagination, improving visibility and debugging in the Admin API.

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.

Inventory transfers can now omit origin or destination IDs, enhancing flexibility. Update app validation to treat these fields as optional. Existing apps remain unaffected.

The 2026-01 Admin GraphQL API adds ACH payment support, introducing BankAccount to PaymentInstrument and CustomerPaymentInstrument unions, enhancing B2B payment management.

The storeCreditAccountCredit mutation now accepts an optional notify parameter. When set to true the account owner will be sent a 'store credit issued email'.

Admin API 2026-01: callbackUrl in fulfillmentServiceCreate and fulfillmentServiceUpdate is now optional. Existing fulfillment services will be unaffected.

The Shop.draftOrders connection is removed in GraphQL Admin API v2026-01. Use QueryRoot.draftOrders to access multiple draft orders.