Developer changelog

The multipassIdentifier field is now available in the Admin GraphQL API for customerCreate and customerUpdate mutations, providing feature parity with the REST Admin API.

Shopify Functions now support user-defined handles in GraphQL mutations, simplifying deployment by removing the need to query for functionId. Existing functionId usage remains supported.

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

As of version 2025-10 of the GraphQL Storefront API, Cart now supports adding gift cards without replacing already applied gift cards.

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

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

Polaris web components are now generally available, supporting Admin, Checkout, Customer Accounts, and POS surfaces via Shopify's CDN.

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

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 productCreate and productUpdate 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 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 new themeDuplicate mutation in Admin GraphQL API allows you to duplicate themes (and optionally rename the duplicate).

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

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.

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

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.

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.

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.

The 2025-10 API update returns an error on false for permitsSkuSharing in fulfillmentServiceCreate and FulfillmentService#create, deprecating non-SKU sharing services.

The @inContext directive now supports visitorConsent for buyer preferences, auto-encoding consent into checkoutUrl, ensuring privacy compliance in Storefront API v2025-10+.

In version 2025-10, collectionReorderProducts mutation's userErrors type changes to CollectionReorderProductsUserError, adding a code field for enhanced error handling.

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

Cart mutations now return a MERCHANDISE NOT APPLICABLE error for invalid merchandise configurations.

The profiles/update webhook now includes fields like name, default, profile_type, and version, improving update reliability and reducing debouncing for rapid profile changes.

New ProductVariantsBulkCreateStrategy to enhance productVariantsBulkCreate capabilities

We’ve introduced a new context field to specify discount eligibility code and automatic discounts. The context field replaces the now deprecated DiscountCustomerSelection field for code discounts.

Webhook GraphQL mutations now support a uri field for all address types, deprecating specific endpoint mutations. webhookSubscriptions query adds uri filtering; callbackUrl is deprecated.

To clear all delivery addresses associated with a cart, call the cartDeliveryAddressesUpdate mutation and set addresses to an empty array.

New fields have been introduced to enable parent-child (nested) relationships between cart lines, supporting use cases such as warranties, engravings, and gift-wrapping.

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.

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

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.

API version 2025-10 adds MERCHANDISE_SELLING_PLAN_NOT_APPLICABLE_ON_COMPANY_LOCATION to CartWarningCode, alerting B2B users when a cart includes a selling plan at a company location.

As of version 2025-10 of the GraphQL Storefront API, you can replace all delivery addresses that are present on a cart in a single operation.

The new [cartDeliveryAddressesReplace...

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 EligibleForShopifyTaxReporting and ShopifyTaxReportingLegacyAutoTaxMigrated fields are removed from ShopFeatures. Update integrations as no replacements exist.

Image alt text is now translatable, allowing developers to register translations via the Translations API.

API version 2025-10 improves order editing with direct session access via OrderEditSession.id, flexible mutation ID support, and enhanced return fields for better workflow tracking.

API version 2025-10 changes fallback for pricing and publishing to use backupRegion settings, ensuring consistency across APIs. Previous versions use store defaults.