Developer changelog

The visibleToStorefrontApi field is deprecated and removed. Use the access field on metaobject definitions.

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.

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.

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.

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.

Increased metafield and metaobject limits: 256 app definitions, 256 merchant definitions, and 1M entries per definition, supporting complex data models and workflows.

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

The "Unlisted" product status is now in the 2025-10 Admin APIs, making products only accessible via a direct URL.

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

Legacy mode profiles are no longer supported.

Subscription contracts now sync shipping requirements from product variants and skip delivery lines for digital orders, ensuring accurate taxes and totals.

The fulfillmentOrdersReroute mutation in the Admin GraphQL API lets developers reroute orders based on delivery strategies, enhancing flexibility and consistency.

GraphQL Admin API 2025-10 adds usdcRebateCreditAmount to ShopifyPaymentsPayoutSummary, providing a total of all usdc rebate credits issued as part of the payout.

The Order object now includes a productNetwork boolean field (2025-10) to identify orders created through the Product Network.

The productSet mutation now uses dynamic complexity costing that more accurately reflects the actual computational cost of operations.

Adds query field shopifyqlQuery to GraphQL Admin API

The productVariantsBulkCreate and productVariantsBulkUpdate mutations now use dynamic complexity costing that more accurately reflects the actual computational cost of operations.

The productVariantsBulkCreate and productVariantsBulkUpdate mutations now validate limits on inventory quantities to support increased variant limit from 100 to 2048 variants per product.

The productCreate and productUpdate mutations now use dynamic complexity costing that more accurately reflects the actual computational cost of operations.

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.

The new themeDuplicate mutation in Admin GraphQL API allows you to duplicate themes (and optionally rename the duplicate).

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.

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

Shopify's Admin GraphQL API now supports article_reference and list.article_reference metafield types, enabling dynamic content linking and improved store customization.

Adds a new 'prevented' status for Disputes and updates the description of all dispute statuses.

You can now access more detailed balance information and due status for payment schedules with three new fields: balanceDue, totalBalance, and due.

API v2025-10: Apps with read_customer_payment_methods scope can now query the mandate connection on CustomerPaymentMethod to access payment method authorizations via resourceType and resourceId.

Order metafield filters in Shopify Admin UI and GraphQL API enhance order management, allowing precise data retrieval and improved operational efficiency for developers and merchants.

The customerPaymentMethodRemoteCreate mutation now has rate limiting to control API usage, ensuring stable performance for all merchants.

Store credit accounts now support company locations, enabling location-specific credit management. B2B customers can view and use credits at checkout. APIs updated for credit queries and transactions.

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.

The FulfillmentEventStatus enum now includes CARRIER_PICKED_UP, allowing merchants to track when carriers collect shipments.

Version 2025-10 allows metaobject fields to include capabilities like admin_filterable, enabling filtering in Shopify admin.

As of 2025-10, set countryCode in CountryHarmonizedSystemCodeInput to null to set a global harmonized system code.

New ProductVariantsBulkCreateStrategy to enhance productVariantsBulkCreate capabilities

The order editing API now supports applying discounts to fulfilled line items, allowing for more accurate financial attribution and reporting.

New guidelines for referenceDocumentUri in inventory adjustments enhance traceability. Supports multiple URI formats, and includes best practices, examples, and migration guides.

Shopify is removing the "Sell from all locations" fulfillable inventory option, requiring shops to configure shipping zones. Apps must ensure inventory is available for delivery to avoid errors.

GraphQL Admin API 2025-10 adds externalTraceId to ShopifyPaymentsPayout, providing the financial institution's reference number for payout tracking.

The orders query now supports current_total_price and total_weight filters, plus sortKey can use CURRENT_TOTAL_PRICE, enhancing data retrieval and sorting options for developers.

The taxCode field in ProductVariant is deprecated as of API version 2025-10. Update your app to remove dependencies on this field due to Avalara AvaTax app discontinuation.

Inventory shipment timestamps are now accessible via the Admin GraphQL API. Use dateCreated, dateReceived, and dateShipped fields.

Added dispute_type filter to OrderListData GraphQL query, enabling filtering of orders by chargeback and/or inquiry.

The discountClass field is deprecated; use discountClasses for multiple discount classes. Continue using presentationLevel to see DraftOrderPlatformDiscount effects.

Shopify Admin API updates: returnRefund deprecated, replaced by returnProcess for streamlined return management. Available now in unstable, official release in 2025-07.