--- 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=2025-10 md: https://shopify.dev/changelog.md?api_type=admin-graphql&api_version=2025-10 --- # 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) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [`multipassIdentifier` field added to GraphQL Admin API](https://shopify.dev/changelog/multipassidentifier-field-added-to-graphql-admin-api) The multipassIdentifier field is now available in the Admin GraphQL API for customerCreate and customerUpdate mutations, providing feature parity with the REST Admin API. [Read full post –>](https://shopify.dev/changelog/multipassidentifier-field-added-to-graphql-admin-api) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [New: Support for USDC Credit field in Shopify Payments Payout GraphQL](https://shopify.dev/changelog/new-support-for-usdc-credit-field-in-shopify-payments-payout-graphql) GraphQL Admin API 2025-10 adds `usdcRebateCreditAmount` to ShopifyPaymentsPayoutSummary, providing a total of all usdc rebate credits issued as part of the payout. [Read full post –>](https://shopify.dev/changelog/new-support-for-usdc-credit-field-in-shopify-payments-payout-graphql) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Rerouting Fulfillment Orders is now possible via API](https://shopify.dev/changelog/rerouting-fulfillment-orders-via-api) The `fulfillmentOrdersReroute` mutation in the Admin GraphQL API lets developers reroute orders based on delivery strategies, enhancing flexibility and consistency. [Read full post –>](https://shopify.dev/changelog/rerouting-fulfillment-orders-via-api) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Subscription contract shipping requirements now sync with product variants](https://shopify.dev/changelog/subscription-contract-shipping-requirements-now-sync-with-product-variants) Subscription contracts now sync shipping requirements from product variants and skip delivery lines for digital orders, ensuring accurate taxes and totals. [Read full post –>](https://shopify.dev/changelog/subscription-contract-shipping-requirements-now-sync-with-product-variants) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [New `productNetwork` field on the `Order` object](https://shopify.dev/changelog/new-productnetwork-field-on-order-object) The Order object now includes a productNetwork boolean field (2025-10) to identify orders created through the Product Network. [Read full post –>](https://shopify.dev/changelog/new-productnetwork-field-on-order-object) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [`productSet` mutation now validates `inventoryQuantities` limits](https://shopify.dev/changelog/productset-limit-for-inventory-quantities) 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. [Read full post –>](https://shopify.dev/changelog/productset-limit-for-inventory-quantities) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Dynamic complexity cost for `productCreate` and `productUpdate` mutations](https://shopify.dev/changelog/dynamic-complexity-cost-for-productcreate-and-productupdate-mutations) The `productCreate` and `productUpdate` mutations now use dynamic complexity costing that more accurately reflects the actual computational cost of operations. [Read full post –>](https://shopify.dev/changelog/dynamic-complexity-cost-for-productcreate-and-productupdate-mutations) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [`productVariantsBulkCreate` and `productVariantsBulkUpdate` mutations now validate `inventoryQuantities` limits](https://shopify.dev/changelog/inventoryquantities-limit-in-mutations) The `productVariantsBulkCreate` and `productVariantsBulkUpdate` mutations now validate limits on inventory quantities to support increased variant limit from 100 to 2048 variants per product. [Read full post –>](https://shopify.dev/changelog/inventoryquantities-limit-in-mutations) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Dynamic complexity cost for `productSet` mutation](https://shopify.dev/changelog/dynamic-complexity-cost-for-productset-mutation) The `productSet` mutation now uses dynamic complexity costing that more accurately reflects the actual computational cost of operations. [Read full post –>](https://shopify.dev/changelog/dynamic-complexity-cost-for-productset-mutation) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [ShopifyQL now available as `shopifyqlQuery` within the GraphQL Admin API](https://shopify.dev/changelog/shopifyqlquery-now-available-in-graphql-admin-api) Adds query field `shopifyqlQuery` to GraphQL Admin API [Read full post –>](https://shopify.dev/changelog/shopifyqlquery-now-available-in-graphql-admin-api) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Duplicate themes with the Admin GraphQL API](https://shopify.dev/changelog/duplicate-themes-with-the-admin-graphql-api) The new `themeDuplicate` mutation in Admin GraphQL API allows you to duplicate themes (and optionally rename the duplicate). [Read full post –>](https://shopify.dev/changelog/duplicate-themes-with-the-admin-graphql-api) * September 23, 2025 Tags: * Admin GraphQL API * Liquid * Storefront GraphQL API * 2025-10 ### [New metafield definition types in GraphQL - article\_reference / list.article\_reference](https://shopify.dev/changelog/new-metafield-definition-types-in-graphql-articlereference-listarticlereference) Shopify's Admin GraphQL API now supports `article_reference` and `list.article_reference` metafield types, enabling dynamic content linking and improved store customization. [Read full post –>](https://shopify.dev/changelog/new-metafield-definition-types-in-graphql-articlereference-listarticlereference) * September 17, 2025 Tags: * Admin GraphQL API * 2025-10 ### [New `mandate` connection added to `CustomerPaymentMethod` object](https://shopify.dev/changelog/new-mandate-connection-added-to-customerpaymentmethod-object) 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. [Read full post –>](https://shopify.dev/changelog/new-mandate-connection-added-to-customerpaymentmethod-object) * September 17, 2025 Tags: * Admin GraphQL API * Customer Account API * 2025-10 ### [New balance and due status fields for PaymentSchedule](https://shopify.dev/changelog/new-balance-and-due-status-fields-for-paymentschedule) You can now access more detailed balance information and due status for payment schedules with three new fields: balanceDue, totalBalance, and due. [Read full post –>](https://shopify.dev/changelog/new-balance-and-due-status-fields-for-paymentschedule) * September 16, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Order metafield definitions and values can now be used as filters in the Shopify Admin UI](https://shopify.dev/changelog/order-metafield-definitions-and-values-can-now-be-used-as-filters-in-the-shopify-admin-ui) 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. [Read full post –>](https://shopify.dev/changelog/order-metafield-definitions-and-values-can-now-be-used-as-filters-in-the-shopify-admin-ui) * September 15, 2025 Tags: * Admin GraphQL API * Customer Account API * 2025-10 ### [Store credit now supports company locations as account owners in Admin and Customer APIs](https://shopify.dev/changelog/store-credit-now-supports-company-locations-as-account-owners-in-admin-and-customer-apis) 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. [Read full post –>](https://shopify.dev/changelog/store-credit-now-supports-company-locations-as-account-owners-in-admin-and-customer-apis) * September 12, 2025 Tags: * Admin GraphQL API * 2025-10 ### [New enum values for FulfillmentEventStatus](https://shopify.dev/changelog/new-carrier-picked-up-fulfillment-status) The `FulfillmentEventStatus` enum now includes `CARRIER_PICKED_UP`, allowing merchants to track when carriers collect shipments. [Read full post –>](https://shopify.dev/changelog/new-carrier-picked-up-fulfillment-status) * September 10, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Metaobject field definitions offer new capabilities](https://shopify.dev/changelog/metaobject-field-capabilities) Version 2025-10 allows metaobject fields to include capabilities like `admin_filterable`, enabling filtering in Shopify admin. [Read full post –>](https://shopify.dev/changelog/metaobject-field-capabilities) * September 5, 2025 Tags: * Action Required * Admin GraphQL API * Admin REST API * 2025-10 ### [Setting `permitsSkuSharing` argument to `false` when creating a fulfillment service returns an error](https://shopify.dev/changelog/setting-permitsskusharing-argument-to-false-when-creating-a-fulfillment-service-returns-an-error) The 2025-10 API update returns an error on `false` for `permitsSkuSharing` in `fulfillmentServiceCreate` and `FulfillmentService#create`, deprecating non-SKU sharing services. [Read full post –>](https://shopify.dev/changelog/setting-permitsskusharing-argument-to-false-when-creating-a-fulfillment-service-returns-an-error) * September 1, 2025 Tags: * Action Required * Admin GraphQL API * 2025-10 ### [CollectionReorderProducts operation userErrors now includes code field](https://shopify.dev/changelog/collectionreorderproducts-operation-usererrors-now-includes-code-field) In version 2025-10, `collectionReorderProducts` mutation's `userErrors` type changes to `CollectionReorderProductsUserError`, adding a `code` field for enhanced error handling. [Read full post –>](https://shopify.dev/changelog/collectionreorderproducts-operation-usererrors-now-includes-code-field) * September 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Global HS code is now supported in GraphQL Admin API](https://shopify.dev/changelog/country-hs-codes-global-value) As of `2025-10`, set `countryCode` in `CountryHarmonizedSystemCodeInput` to `null` to set a global harmonized system code. [Read full post –>](https://shopify.dev/changelog/country-hs-codes-global-value) * August 21, 2025 Tags: * Admin GraphQL API * 2025-10 ### [New PRESERVE\_STANDALONE\_VARIANT strategy for the productVariantsBulkCreate mutation](https://shopify.dev/changelog/new-preservestandalonevariant-strategy-for-productvariantsbulkcreate-mutation) New ProductVariantsBulkCreateStrategy to enhance productVariantsBulkCreate capabilities [Read full post –>](https://shopify.dev/changelog/new-preservestandalonevariant-strategy-for-productvariantsbulkcreate-mutation) * August 18, 2025 Tags: * Action Required * Admin GraphQL API * 2025-10 ### [Introducing the new `context` field to specify discount eligibility](https://shopify.dev/changelog/discount-eligibility-management) 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. [Read full post –>](https://shopify.dev/changelog/discount-eligibility-management) * August 8, 2025 Tags: * Admin GraphQL API * 2025-10 ### [`webhookSubscriptionCreate` and `webhookSubscriptionUpdate` support all URI types](https://shopify.dev/changelog/consolidate-webhook-graphql-surfaces) Webhook GraphQL mutations now support a `uri` field for all address types, deprecating specific endpoint mutations. `webhookSubscriptions` query adds `uri` filtering; `callbackUrl` is deprecated. [Read full post –>](https://shopify.dev/changelog/consolidate-webhook-graphql-surfaces) * August 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Orders query now supports `current_total_price` and `total_weight` filters and `CURRENT_TOTAL_PRICE` as a `sortKey`](https://shopify.dev/changelog/orders-query-now-supports-currenttotalprice-and-totalweight-filters-and-currenttotalprice-as-a-sortkey) 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. [Read full post –>](https://shopify.dev/changelog/orders-query-now-supports-currenttotalprice-and-totalweight-filters-and-currenttotalprice-as-a-sortkey) * August 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Shopify Payments Payout GraphQL type supports `external_trace_id`](https://shopify.dev/changelog/shopify-payments-payout-graphql-type-supports-externaltraceid) GraphQL Admin API 2025-10 adds `externalTraceId` to ShopifyPaymentsPayout, providing the financial institution's reference number for payout tracking. [Read full post –>](https://shopify.dev/changelog/shopify-payments-payout-graphql-type-supports-externaltraceid) * July 30, 2025 Tags: * Action Required * Admin GraphQL API * Admin REST API * 2025-10 ### [Deprecation of the `ProductVariant.taxCode` field](https://shopify.dev/changelog/deprecation-of-tax-code-field) 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. [Read full post –>](https://shopify.dev/changelog/deprecation-of-tax-code-field) * July 15, 2025 Tags: * Admin GraphQL API * 2025-10 ### [New fields for inventory shipment timestamps](https://shopify.dev/changelog/inventory-shipment-timestamp-fields) Inventory shipment timestamps are now accessible via the Admin GraphQL API. Use `dateCreated`, `dateReceived`, and `dateShipped` fields. [Read full post –>](https://shopify.dev/changelog/inventory-shipment-timestamp-fields) * July 12, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Add option to filter by dispute type in OrderListQuery GraphQL query](https://shopify.dev/changelog/add-option-to-filter-by-dispute-type-in-order-list) Added `dispute_type` filter to `OrderListData` GraphQL query, enabling filtering of orders by `chargeback` and/or `inquiry`. [Read full post –>](https://shopify.dev/changelog/add-option-to-filter-by-dispute-type-in-order-list) * June 30, 2025 Tags: * Action Required * Admin GraphQL API * 2025-10 ### [Removed tax-related fields from the `ShopFeatures` object](https://shopify.dev/changelog/removed-tax-related-fields-from-the-shopfeatures-object) The `EligibleForShopifyTaxReporting` and `ShopifyTaxReportingLegacyAutoTaxMigrated` fields are removed from `ShopFeatures`. Update integrations as no replacements exist. [Read full post –>](https://shopify.dev/changelog/removed-tax-related-fields-from-the-shopfeatures-object) * June 29, 2025 Tags: * Admin GraphQL API * Liquid * Storefront GraphQL API * 2025-10 ### [Image alt text can now be translated](https://shopify.dev/changelog/mark-image-alt-text-as-translatable) Image alt text is now translatable, allowing developers to register translations via the Translations API. [Read full post –>](https://shopify.dev/changelog/mark-image-alt-text-as-translatable) * June 19, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Order editing workflows now offer direct session access via mutation arguments and return fields](https://shopify.dev/changelog/order-editing-workflows-now-offer-direct-session-access-via-mutation-arguments-and-return-fields) 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. [Read full post –>](https://shopify.dev/changelog/order-editing-workflows-now-offer-direct-session-access-via-mutation-arguments-and-return-fields) * June 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Contextual pricing and publishing APIs use backup region fallback](https://shopify.dev/changelog/contextual-pricing-and-publishing-apis-use-backup-region-fallback) API version 2025-10 changes fallback for pricing and publishing to use `backupRegion` settings, ensuring consistency across APIs. Previous versions use store defaults. [Read full post –>](https://shopify.dev/changelog/contextual-pricing-and-publishing-apis-use-backup-region-fallback)